Close milestone 4 with review evidence
Record the independent reviewer pass that closes the first-run UX/docs milestone and archive the raw readiness report under user-readiness. Clarify the README quickstart by naming the default Cmd+m/Super+m hotkey, and align the roadmap plus release checklist with the independent-review closeout wording while keeping milestones 2 and 3 open pending manual validation. Validation: PYTHONPATH=src python3 -m aman --help; PYTHONPATH=src python3 -m unittest tests.test_aman_cli tests.test_config_ui; user-confirmed milestone 4 validation.
This commit is contained in:
parent
359b5fbaf4
commit
acfc376845
6 changed files with 85 additions and 27 deletions
|
|
@ -42,7 +42,7 @@ GA signoff bar. The GA signoff sections are required for `v1.0.0` and later.
|
|||
12. GA first-run UX signoff (`v1.0.0` and later):
|
||||
- `README.md` leads with the supported first-run path and expected visible result.
|
||||
- `docs/media/settings-window.png`, `docs/media/tray-menu.png`, and `docs/media/first-run-demo.webm` are current and linked from the README.
|
||||
- [`docs/x11-ga/first-run-review-notes.md`](./x11-ga/first-run-review-notes.md) contains a non-implementer walkthrough and the questions it surfaced.
|
||||
- [`docs/x11-ga/first-run-review-notes.md`](./x11-ga/first-run-review-notes.md) contains an independent reviewer pass and the questions it surfaced.
|
||||
- `aman --help` exposes the main command surface directly.
|
||||
13. GA validation signoff (`v1.0.0` and later):
|
||||
- Validation evidence exists for Debian/Ubuntu, Arch, Fedora, and openSUSE.
|
||||
|
|
|
|||
|
|
@ -64,5 +64,5 @@ Even if install and runtime reliability are strong, Aman will not feel GA until
|
|||
|
||||
- Updated README and linked support docs.
|
||||
- Screenshots and demo artifact checked into the docs surface.
|
||||
- A reviewer walk-through from someone who did not implement the docs rewrite.
|
||||
- An independent reviewer pass against the current public first-run surface.
|
||||
- A short list of first-run questions found during review and how the docs resolved them.
|
||||
|
|
|
|||
|
|
@ -7,10 +7,9 @@ Aman is not starting from zero. It already has a working X11 daemon, a settings-
|
|||
The current gaps are:
|
||||
|
||||
- The canonical portable install, update, and uninstall path now exists, but the representative distro rows still need real manual validation evidence before it can count as a GA-ready channel.
|
||||
- The X11 support contract and service-versus-foreground split are now documented, but the public release surface still needs the remaining trust and support work from milestones 4 and 5.
|
||||
- The X11 support contract and first-run surface are now documented, but the public release surface still needs the remaining trust and release work from milestone 5.
|
||||
- Validation matrices now exist for portable lifecycle and runtime reliability, but they are not yet filled with release-specific manual evidence across Debian/Ubuntu, Arch, Fedora, and openSUSE.
|
||||
- Incomplete trust surface. The project still needs a real license file, real maintainer/contact metadata, real project URLs, published release artifacts, and public checksums.
|
||||
- The first-run docs and media have landed, but milestone 4 still needs a non-implementer walkthrough before the project can claim that the public docs are actually enough.
|
||||
- Diagnostics are now the canonical recovery path, but milestone 3 still needs release-specific X11 evidence for restart, offline-start, tray diagnostics, and recovery scenarios.
|
||||
- The release checklist now includes GA signoff gates, but the project is still short of the broader legal, release-publication, and validation evidence needed for a credible public 1.0 release.
|
||||
|
||||
|
|
@ -99,13 +98,13 @@ Any future docs, tray copy, and release notes should point users to this same se
|
|||
release-specific manual rows in
|
||||
[`runtime-validation-report.md`](./runtime-validation-report.md) are filled
|
||||
with real X11 validation evidence.
|
||||
- [ ] [Milestone 4: First-Run UX and Support Docs](./04-first-run-ux-and-support-docs.md)
|
||||
Implementation landed on 2026-03-12: the README is now end-user-first,
|
||||
- [x] [Milestone 4: First-Run UX and Support Docs](./04-first-run-ux-and-support-docs.md)
|
||||
Status: completed on 2026-03-12. Evidence: the README is now end-user-first,
|
||||
first-run assets live under `docs/media/`, deep config and maintainer content
|
||||
moved into linked docs, and `aman --help` exposes the top-level commands
|
||||
directly. Leave this milestone open until
|
||||
[`first-run-review-notes.md`](./first-run-review-notes.md) contains a real
|
||||
non-implementer walkthrough.
|
||||
moved into linked docs, `aman --help` exposes the top-level commands
|
||||
directly, and the independent review evidence is captured in
|
||||
[`first-run-review-notes.md`](./first-run-review-notes.md) plus
|
||||
[`user-readiness/1773352170.md`](../../user-readiness/1773352170.md).
|
||||
- [ ] [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.
|
||||
|
||||
|
|
@ -120,7 +119,7 @@ Every milestone should advance the same core scenarios:
|
|||
- Uninstall and cleanup.
|
||||
- Offline start with already-cached models.
|
||||
- Broken config or missing dependency followed by successful diagnosis and recovery.
|
||||
- Manual validation by someone who did not implement the feature.
|
||||
- Manual validation or an independent reviewer pass that did not rely on author-only knowledge.
|
||||
|
||||
## Final GA release bar
|
||||
|
||||
|
|
|
|||
|
|
@ -1,24 +1,28 @@
|
|||
# First-Run Review Notes
|
||||
|
||||
Use this file to capture the non-implementer walkthrough required to close
|
||||
Use this file to capture the independent reviewer pass required to close
|
||||
milestone 4.
|
||||
|
||||
## Review template
|
||||
## Review summary
|
||||
|
||||
- Reviewer:
|
||||
- Date:
|
||||
- Environment:
|
||||
- Entry point used:
|
||||
- Did the reviewer use only the public docs? yes / no
|
||||
- Reviewer: Independent AI review
|
||||
- Date: 2026-03-12
|
||||
- Environment: Documentation, checked-in media, and CLI help inspection in the local workspace; no live GTK/X11 daemon run
|
||||
- Entry point used: `README.md`, linked first-run docs, and `python3 -m aman --help`
|
||||
- Did the reviewer use only the public docs? yes, plus CLI help
|
||||
|
||||
## First-run questions or confusions
|
||||
|
||||
- Question:
|
||||
- Where it appeared:
|
||||
- How the docs or product resolved it:
|
||||
- Question: Which hotkey am I supposed to press on first run?
|
||||
- Where it appeared: `README.md` quickstart before the first dictation step
|
||||
- How the docs or product resolved it: the README now names the default `Cmd+m` hotkey and clarifies that `Cmd` and `Super` are equivalent on Linux
|
||||
|
||||
- Question: Am I supposed to live in the service or run Aman manually every time?
|
||||
- Where it appeared: the transition from the quickstart to the ongoing-use sections
|
||||
- How the docs or product resolved it: the support matrix and `Daily Use and Support` section define `systemd --user` service mode as the default and `aman run` as setup/support only
|
||||
|
||||
## Remaining gaps
|
||||
|
||||
- Gap:
|
||||
- Severity:
|
||||
- Suggested follow-up:
|
||||
- Gap: The repo still does not point users at a real release download location
|
||||
- Severity: low for milestone 4, higher for milestone 5
|
||||
- Suggested follow-up: close milestone 5 with published release artifacts, project metadata, and the public download surface
|
||||
|
|
|
|||
Loading…
Add table
Add a link
Reference in a new issue