Skip to content

Commit e3d1228

Browse files
committed
docs(publishing): remove incorrect manual bootstrap step for versioning
The snapshot-docs job in publish-release.yml handles the first version snapshot automatically on the first final release. No manual bootstrap is needed. Assisted-by: Claude Code Signed-off-by: Nigel Jones <jonesn@uk.ibm.com>
1 parent 42b1af7 commit e3d1228

1 file changed

Lines changed: 4 additions & 12 deletions

File tree

docs/PUBLISHING.md

Lines changed: 4 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -106,18 +106,10 @@ Docusaurus versioning is integrated into the release pipeline:
106106
- **Version dropdown** in the navbar lets users switch between released
107107
versions and `main (unreleased)`.
108108

109-
**Bootstrap (one-time, after merge):** before the first final release fires
110-
the automatic pipeline, manually create the first snapshot so the version
111-
dropdown is populated:
112-
113-
```bash
114-
cd docs && npm run docusaurus -- docs:version X.Y.Z
115-
# (X.Y.Z = current latest released tag)
116-
```
117-
118-
Commit the resulting `versioned_docs/`, `versioned_sidebars/`,
119-
`versions.json`, and the `lastVersion` edit in `docusaurus.config.ts`
120-
to `main`.
109+
No manual bootstrap is needed — the first final release run triggers
110+
`snapshot-docs` automatically, which creates the initial snapshot and
111+
updates `lastVersion`. Until the first final release, the site shows only
112+
`main (unreleased)` in the version dropdown, which is correct.
121113

122114
## Local development
123115

0 commit comments

Comments
 (0)