Skip to content

Release version 1.49 documentation - #1375

Merged
ifbyol merged 2 commits into
mainfrom
doc-version-149
Oct 8, 2026
Merged

ifbyol merged 2 commits into
mainfrom
doc-version-149

Conversation

@ifbyol

@ifbyol ifbyol commented Oct 8, 2026

Copy link
Copy Markdown
Member

Summary

Cuts the 1.49 docs version following the README versioning steps.

  • Snapshot: yarn run docusaurus docs:version 1.49 creates versioned_docs/version-1.49/ and versioned_sidebars/version-1.49-sidebars.json
  • docusaurus.config.js: lastVersion is 1.49 at /, 1.48 moves to /1.48 with the unmaintained banner, current is 1.50, and the 1.43 entry is removed
  • netlify.toml: /docs/1.49/* redirects to the docs root, /docs/unreleased/* redirects to 1.50, and a deprecated redirect is added for /docs/1.37/*
  • src/pages/archives.md: 1.49 is the current version, 1.48 is added to previous versions, and 1.37 is removed
  • 1.37 archived: removes versioned_docs/version-1.37/ and its sidebar, removes it from versions.json (12 versions remain, 1.49 to 1.38), and moves the 1.37.0 to 1.37.3 release notes to archived-release-notes.mdx
  • 1.49.0 release notes: date set to 8 October 2026, CLI link points to the 3.24.0 tag, the compression entry links to the buildOpts Helm setting and the Admin Variables reference, and an extra blank line is removed
  • README: corrects step 3 and the Quick Reference. The versions object in docusaurus.config.js lists only the official version and the five before it, so the entry to remove is NEW_VERSION - 6, not the oldest version in versions.json

src/content/variables.json already has the 1.49 values from #1353 (CLI 3.24.0, Chart 1.49.0, Kubernetes 1.34 to 1.36). CLI 3.24.0 still ships Syncthing 2.1.3.

Verification

  • yarn build passes with no broken links or anchors
  • The build outputs build/docs/1.48 and build/docs/1.50, and no build/docs/1.37

After merge

🤖 Generated with Claude Code

Snapshots src/content into versioned_docs/version-1.49, rolls the
docusaurus and netlify version config forward (1.49 official, 1.50
unreleased), finalizes the 1.49.0 release-notes date and CLI link, and
archives 1.37.

Also corrects the README versioning steps: the docusaurus.config.js
versions object only lists the official version and the five before it,
so the entry to remove is NEW_VERSION - 6, not the oldest version in
versions.json.

Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
Signed-off-by: Nacho Fuertes <nacho@okteto.com>
Copilot AI balanced review requested due to automatic review settings October 8, 2026 11:26
@ifbyol
ifbyol requested a review from pchico83 as a code owner October 8, 2026 11:26
@netlify

netlify Bot commented Oct 8, 2026 •

Copy link
Copy Markdown

✅ Deploy Preview for okteto-docs ready!

Name Link
🔨 Latest commit cb97fd2
🔍 Latest deploy log https://app.netlify.com/projects/okteto-docs/deploys/6ac7878eb94adf0008272cc5
😎 Deploy Preview https://deploy-preview-1375--okteto-docs.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify project configuration.

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🟡 Changes recommended

The stable 1.49 snapshot does not archive the 1.37 release notes as described.

1 open finding
What changed in this PR

Cuts the 1.49 documentation release, advances unreleased docs to 1.50, and retires 1.37.

Changes:

  • Adds the 1.49 documentation and sidebar snapshots.
  • Updates version routing, archives, and redirects.
  • Archives 1.37 documentation and release notes.
File Description
versioned_docs/​version-1.49/​** Adds the 1.49 documentation snapshot.
versioned_sidebars/​version-1.49-sidebars.json Adds the 1.49 sidebar snapshot.
versioned_docs/​version-1.37/​** Removes the retired 1.37 snapshot.
versioned_sidebars/​version-1.37-sidebars.json Removes the retired sidebar.
versions.json Adds 1.49 and removes 1.37.
docusaurus.config.js Makes 1.49 stable and 1.50 unreleased.
netlify.toml Updates stable, unreleased, and deprecated redirects.
src/​pages/​archives.md Updates current and archived version listings.
src/​content/​release-notes.mdx Removes the archived 1.37 notes.
src/​content/​archived-release-notes.mdx Adds the 1.37 release notes.
README.md Corrects version configuration instructions.

🧠 Review effort: Balanced


Give feedback about Copilot approvals in this survey to enter a drawing for a $150 gift card.

Comment thread versioned_docs/version-1.49/release-notes.mdx Outdated
The official version is served from versioned_docs/version-1.49, so
moving the 1.37 notes only in src/content left them in the live release
notes and out of the live archive. Apply the same move to the snapshot.

Reorder the README versioning steps so the release notes are archived
before running docs:version, which keeps future snapshots consistent.

Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
Signed-off-by: Nacho Fuertes <nacho@okteto.com>

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🟢 Approval recommended

Version configuration, redirects, archives, release metadata, and snapshot contents are consistent.

0 open findings

1 resolved since last review

🧠 Review effort: Balanced


Give feedback about Copilot approvals in this survey to enter a drawing for a $150 gift card.

@ifbyol
ifbyol requested a review from jLopezbarb October 8, 2026 14:42
@ifbyol
ifbyol merged commit 1776084 into main Oct 8, 2026
5 checks passed
@ifbyol
ifbyol deleted the doc-version-149 branch October 8, 2026 14:54
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.

3 participants