Fix stale Getting Started docs (non-existent staging environment and mismatched layout) #80
Labels
No labels
automation
automerge
ci
infra
migrated/beads
priority/P2
refactoring
repo-maintenance
status/in-progress
testing
type/epic
type/task
automerge
bug
dependencies
duplicate
help wanted
invalid
lang
rust
migrations
opencode
question
security
type
documentation
type
enhancement
type
maintenance
type
refactor
vulnerability
wontfix
No milestone
No project
No assignees
1 participant
Notifications
Due date
No due date set.
Reference
Personal/cluster#80
Loading…
Reference in a new issue
No description provided.
Delete branch "%!s()"
Deleting a branch is permanent. Although the deleted branch may continue to exist for a short time before it actually gets removed, it CANNOT be undone in most cases. Continue?
Context
Follow-up discovered while preparing #76 (repository transfer to
Personal/cluster).README.md"Getting Started" documents a workflow that does not match the repository:stagingenvironment (just build staging,just bootstrap staging,just switch staging,manifests/staging/,apps-staging). Onlydev,infra, andprodexist inflake.nix.bootstraprecipe does exist (nix run .#nixidy -- bootstrap .#{{ env }} | kubectl apply -f -), but the README does not say it is a one-time action per environment nor what it creates.manifests/{env}/apps/, while the generated directories aremanifests/{env}/apps-{env}/.just diff {env}recipe or thatjust switchrunsgit add ..Goal
Make the contributor onboarding instructions match the real bootstrap path,
justrecipes, and generated directory layout, so a new contributor can reproduce the setup without guessing.Acceptance criteria
stagingexamples inREADME.mdare replaced withdev(or another existing environment).bootstrapis documented as a one-time per-environment step, including what it applies and the resultingApplicationnames (apps-{dev,infra,prod}).apps-{env},argocd, per-app directories).justfile(just --listoutput matches the docs), andjust diff {env}is mentioned for reviewing generated manifests.Related: #76
Fix stale Getting Started docs (non-existentto Fix stale Getting Started docs (non-existentjust bootstraprecipe andstagingenvironment)stagingenvironment and mismatched layout)martin referenced this issue2026-11-15 20:53:19 +00:00