From c54b9288606f390abb4bf691355760ebec941b42 Mon Sep 17 00:00:00 2001 From: Leynos Date: Wed, 22 Apr 2026 11:41:51 +0000 Subject: [PATCH 1/2] docs(roadmap): mark advanced usage documentation chapter as complete Updated the roadmap to reflect completion of the advanced usage documentation chapter, including coverage of `clean`, `graph`, `manifest`, configuration layering, and JSON diagnostics. Co-authored-by: devboxerhub[bot] --- docs/roadmap.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/roadmap.md b/docs/roadmap.md index a49bfcb4..e9e43874 100644 --- a/docs/roadmap.md +++ b/docs/roadmap.md @@ -318,8 +318,8 @@ library, and CLI ergonomics. - [x] 3.13.1. Add smoke tests for novice flows. - [x] Test first run success, missing manifest, and help output. - [x] Confirm UX matches documented journey. -- [ ] 3.13.2. Extend user documentation with advanced usage chapter. - - [ ] Cover `clean`, `graph`, `manifest`, configuration layering, and JSON +- [x] 3.13.2. Extend user documentation with advanced usage chapter. + - [x] Cover `clean`, `graph`, `manifest`, configuration layering, and JSON diagnostics. - [ ] 3.13.3. Provide CI-focused guidance. - [ ] Include examples of consuming JSON diagnostics. From b273256ea9f7d963f6ee9a00e3b274e0d26e9943 Mon Sep 17 00:00:00 2001 From: Leynos Date: Wed, 22 Apr 2026 22:25:06 +0000 Subject: [PATCH 2/2] docs(users-guide): document advanced usage as executable behavioural tests The Advanced Usage chapter in `docs/users-guide.md` is validated by behavioural tests in `tests/features/advanced_usage.feature`. Netsuke treats those scenarios as executable documentation for the `clean`, `graph`, and `manifest` subcommands, configuration layering, and JSON diagnostics so the guide stays synchronized with runtime behaviour rather than drifting behind it. Co-authored-by: devboxerhub[bot] --- docs/netsuke-design.md | 6 ++++++ 1 file changed, 6 insertions(+) diff --git a/docs/netsuke-design.md b/docs/netsuke-design.md index d2738947..ac902e4b 100644 --- a/docs/netsuke-design.md +++ b/docs/netsuke-design.md @@ -2109,6 +2109,12 @@ reporter output, timing summaries, and the semantic prefix surface are guarded by `insta` snapshots so spacing, prefix alignment, and wrapping regressions fail with reviewable diffs instead of drifting silently. +The Advanced Usage chapter in `docs/users-guide.md` is validated by behavioural +tests in `tests/features/advanced_usage.feature`. Netsuke treats those +scenarios as executable documentation for the `clean`, `graph`, and `manifest` +subcommands, configuration layering, and JSON diagnostics so the guide stays +synchronized with runtime behaviour rather than drifting behind it. + For screen readers: The following flowchart shows how the build script audits localization keys against English and Spanish Fluent bundles.