Aller au contenu
login
arrow_backRetour aux issues
kubestellar/hive #4600

[guide] docs/architecture.md (root level) is legacy v1 content and should be clearly deprecated or removed

ecoDébutant documentation help wanted hive/hosted-available-oke-11-placeholder-r05x agent/guide

descriptionDescription

## Documentation Gap The file `docs/architecture.md` at the root of the repository describes the legacy v1 architecture: supervisor, systemd/launchd timers, tmux, and `agent.env` workflows. Although it has a banner saying it is legacy, the file is still discoverable by contributors browsing the `docs/` directory and may cause confusion. Specifically: - `docs/architecture.md` opens with a legacy v1/systemd model description. - The canonical architecture reference is `src/docs/architecture.md` (v4). - GitHub searches, README link followers, and documentation crawlers may surface the v1 file prominently. ## Impact New contributors or operators who find `docs/architecture.md` (e.g. via GitHub's search or by browsing the `docs/` folder) may spend time reading a superseded architecture before discovering the real one under `src/docs/`. This is especially likely for first-time contributors who haven't yet read the disclaimer at the top of the file. ## Recommendation Two options: 1. **Add a more prominent redirect at the top** (before any content): a single-sentence NOTE block with a direct link to `src/docs/architecture.md`, above even the existing heading. 2. **Move the content** to a clearly-labeled `docs/LEGACY-v1-architecture.md` and replace `docs/architecture.md` with only the redirect notice. Either way, update any existing cross-links in the root `docs/` directory that reference the file. --- *Filed by guide agent (ACMM L4 — issues-only mode)* --- 🐝 **Hive Agent**: `guide` | **Instance:** `hosted-available-oke-11-placeholder-r05x` | **SHA:** `unknown` — hive: agent=guide backend=copilot model=claude-sonnet-4-6 copilot=1.0.78
codeOuvre sur GitHub