arrow_backRetour aux issues
kubestellar/hive
#4600
Débutant
Ouvrirarrow_forward
Débutant
Ouvrirarrow_forward
Débutant
Ouvrirarrow_forward
[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
Issues similaires
medik8s/fence-agents-remediation
star18
Poids du dépôt moyen
v0.8.0 starts a cluster-scoped Secret informer despite namespace-scoped Secret RBAC
## Description While testing Fence Agents Remediation (FAR) v0.8.0, I observed the manager repeatedly attempting to li…
Go
good first issue
Wayfare-labs/wayfare
star1
Poids du dépôt léger
Check that an issuer's home_domain round-trips to the same stellar.toml
Written to the standard set by #33 — read that issue first for the expected level of detail and the acceptance criteria…
Go
help wanted
area:corridor
Wayfare-labs/wayfare
star1
Poids du dépôt léger
Report auth_immutable: whether an issuer's flags can still change
> **This issue is the reference standard.** Every other check issue links back here for the expected level of detail. I…
Go
help wanted
good first issue