Skip to content

Commit 5f72cef

Browse files
committed
Archived change docs alignment
1 parent a5293dc commit 5f72cef

7 files changed

Lines changed: 6 additions & 5 deletions

File tree

openspec/changes/docs-cli-command-alignment/.openspec.yaml renamed to openspec/changes/archive/2026-03-20-docs-cli-command-alignment/.openspec.yaml

File renamed without changes.

openspec/changes/docs-cli-command-alignment/TDD_EVIDENCE.md renamed to openspec/changes/archive/2026-03-20-docs-cli-command-alignment/TDD_EVIDENCE.md

File renamed without changes.

openspec/changes/docs-cli-command-alignment/design.md renamed to openspec/changes/archive/2026-03-20-docs-cli-command-alignment/design.md

File renamed without changes.

openspec/changes/docs-cli-command-alignment/proposal.md renamed to openspec/changes/archive/2026-03-20-docs-cli-command-alignment/proposal.md

File renamed without changes.

openspec/changes/docs-cli-command-alignment/specs/modules-docs-publishing/spec.md renamed to openspec/changes/archive/2026-03-20-docs-cli-command-alignment/specs/modules-docs-publishing/spec.md

File renamed without changes.

openspec/changes/docs-cli-command-alignment/tasks.md renamed to openspec/changes/archive/2026-03-20-docs-cli-command-alignment/tasks.md

File renamed without changes.

openspec/specs/modules-docs-publishing/spec.md

Lines changed: 6 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -5,13 +5,14 @@ TBD - created by archiving change docs-01-modules-docs-canonical-site. Update Pu
55
## Requirements
66
### Requirement: Modules docs site is the canonical home for official bundle documentation
77

8-
The modules documentation site SHALL present itself as the canonical published home for official bundle and module-specific deep documentation.
8+
The modules documentation site SHALL present itself as the canonical published home for official bundle and module-specific deep documentation, and its command examples SHALL match the currently mounted CLI surface shipped with the official modules.
99

10-
#### Scenario: Reader opens modules landing page
10+
#### Scenario: Reader follows a command example from the modules docs
1111

12-
- **WHEN** a reader opens the modules docs landing page
13-
- **THEN** the page states that official bundle and module-specific deep guidance is owned by `specfact-cli-modules`
14-
- **AND** the page does not describe the GitHub Pages project-path URL as the long-term canonical public identity.
12+
- **WHEN** a reader copies a command example from the modules docs reference or installation pages
13+
- **THEN** the example uses a command path that is currently mounted in `specfact --help`
14+
- **AND** the example does not rely on removed top-level shims such as flat `sync`, `repro`, `validate`, or `enforce` command groups when the mounted path is nested under another group
15+
- **AND** official bundle install examples use the current published module ids from `specfact-cli-modules`
1516

1617
### Requirement: Modules docs expose shared cross-site navigation
1718

0 commit comments

Comments
 (0)