Skip to content

Finalize v6 as the latest docs version#405

Open
nohwnd wants to merge 1 commit into
mainfrom
nohwnd-finalize-v6-docs
Open

Finalize v6 as the latest docs version#405
nohwnd wants to merge 1 commit into
mainfrom
nohwnd-finalize-v6-docs

Conversation

@nohwnd

@nohwnd nohwnd commented Jul 3, 2026

Copy link
Copy Markdown
Member

What

Prepares the docs to make v6 the current/latest version and removes the work-in-progress markers now that v6 is being finalized.

Changes

docusaurus.config.js — v6 is now latest

  • lastVersion: "v5""current" (v6 content lives in /docs)
  • Version label "v6 (preview) 🚧""v6"
  • path: "v6""" so v6 serves at unversioned /docs/...
  • Updated the explanatory comments

static/_redirects — redirect the now-latest version's versioned URL

  • /docs/v5/*/docs/v6/*/docs/:splat, so legacy /docs/v6 preview links resolve to /docs. v5 now keeps its own /docs/v5/... URLs.

docs/migrations/v5-to-v6.mdx — remove work-in-progress notices

  • Deleted the :::warning Pester 6.0.0 is in preview admonition
  • Reworded the :::note Experimental / preview skills note to drop the release-candidate framing (kept the "review the diff / re-run your suite" advice)

Banner

v5 now shows the same "unmaintained" banner as v4"This is documentation for Pester v5, which is no longer actively maintained. For up-to-date documentation, see the latest version (v6)." This comes automatically from the lastVersion change, the same default mechanism v4 already uses (no explicit per-version banner config).

Verification

Ran a full yarn build:

  • v6 serves at /docs, labeled just "v6", no banner
  • v5 (/docs/v5) and v4 (/docs/v4) show identical unmaintained banners pointing to v6 as latest
  • Version dropdown lists v6, v5, v4; build succeeded with no errors

Notes

  • versions.json stays ["v5", "v4"] — v6 is the "current" version, not a cut/versioned one.
  • Left the feature-level :::warning Experimental notices (parallel execution, result object) untouched — those describe experimental features within released v6, not preview status.

- Set lastVersion to "current" (v6) and serve it at unversioned /docs
- Drop the "(preview) 🚧" label from the v6 version dropdown
- Redirect /docs/v6/* to /docs so legacy preview URLs keep working;
  v5 now keeps its own /docs/v5/* URLs and shows the same
  "unmaintained" banner as v4
- Remove work-in-progress preview notices from the v5-to-v6 guide

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants