-
Notifications
You must be signed in to change notification settings - Fork 0
Wiki Maintenance
Jim Daley edited this page May 3, 2026
·
3 revisions
Wiki pages are refreshed from repository source files and the wiki branch. The current style is visual-first: diagrams, tables, lifecycle maps, and direct artifact links.
flowchart LR
Repo["Aeostara repo"] --> Generator["generate_wiki_pages.py"]
Generator --> Wiki["Wiki working tree"]
Wiki --> Review["Preview / diff"]
Review --> Push["Push wiki commit"]
| Family | How it is maintained |
|---|---|
| Home and branch overview | Generated from repository state |
| Contract pages | Generated from specs/contracts/*.schema.json
|
| Algorithm pages | Generated from specs/algorithms/*.md
|
| Architecture pages | Generated from specs/architecture/*.md
|
| Acceptance pages | Generated from specs/acceptance/*.md
|
| Top-level guide pages | Curated in the wiki for visual navigation |
| Sidebar | Curated in the wiki for quick movement |
- Every generated page has a visual context diagram.
- Every generated page has a reading checklist.
- Top-level pages show workflows, state machines, and artifact maps.
- Links point to wiki page names rather than raw files where possible.
- Maintenance wording does not attribute content to a model or external writer.