thaloco/aman
1
Fork 0
Code Pull requests Releases Packages Activity Actions

Define the X11 support contract for milestone 1

Browse source 
Clarify the current release channels versus the X11 GA target so the project has an explicit support promise before milestone 2 delivery work begins.

Update the README, persona and distribution docs, and release checklist with a support matrix, the systemd --user daily-use path, the manual aman run support path, and the canonical recovery sequence. Mark milestone 1 complete in the roadmap once that contract is documented.

Align run, doctor, and self-check help text with the same service and diagnostics language without changing command behavior.

Validated with PYTHONPATH=src python3 -m aman --help, PYTHONPATH=src python3 -m aman doctor --help, and PYTHONPATH=src python3 -m aman self-check --help. Excludes generated src/aman.egg-info and prior user-readiness notes.
This commit is contained in:
Thales Maciel 2026-03-12 14:14:24 -03:00
parent 01a580f359
commit 9ccf73cff5
5 changed files with 149 additions and 38 deletions
Download patch file Download diff file Expand all files Collapse all files

24
docs/x11-ga/README.md
View file

@ -80,16 +80,20 @@ Any future docs, tray copy, and release notes should point users to this same se
## Milestones
1. [Milestone 1: Support Contract and GA Bar](./01-support-contract-and-ga-bar.md)
Lock the public promise, supported environment, and final signoff bar.
2. [Milestone 2: Portable Install, Update, and Uninstall](./02-portable-install-update-uninstall.md)
Build one reliable end-user lifecycle that works across mainstream X11 distros.
3. [Milestone 3: Runtime Reliability and Diagnostics](./03-runtime-reliability-and-diagnostics.md)
Make startup, failure handling, and recovery predictable.
4. [Milestone 4: First-Run UX and Support Docs](./04-first-run-ux-and-support-docs.md)
Turn the product from "documented by the author" into "understandable by a new user."
5. [Milestone 5: GA Candidate Validation and Release](./05-ga-candidate-validation-and-release.md)
Close the remaining trust, legal, release, and validation work for a public 1.0 launch.
- [x] [Milestone 1: Support Contract and GA Bar](./01-support-contract-and-ga-bar.md)
Status: completed on 2026-03-12. Evidence: `README.md` now defines the
support matrix, daily-use versus manual mode, and recovery sequence;
`docs/persona-and-distribution.md` now separates current release channels from
the GA contract; `docs/release-checklist.md` now includes GA signoff gates;
CLI help text now matches the same service/support language.
- [ ] [Milestone 2: Portable Install, Update, and Uninstall](./02-portable-install-update-uninstall.md)
Build one reliable end-user lifecycle that works across mainstream X11 distros.
- [ ] [Milestone 3: Runtime Reliability and Diagnostics](./03-runtime-reliability-and-diagnostics.md)
Make startup, failure handling, and recovery predictable.
- [ ] [Milestone 4: First-Run UX and Support Docs](./04-first-run-ux-and-support-docs.md)
Turn the product from "documented by the author" into "understandable by a new user."
- [ ] [Milestone 5: GA Candidate Validation and Release](./05-ga-candidate-validation-and-release.md)
Close the remaining trust, legal, release, and validation work for a public 1.0 launch.
## Cross-milestone acceptance scenarios