docs: Fix broken versioning of changelog (#1829)

## Summary

- Replace manual `cp CHANGELOG.md` in build scripts with a Docusaurus
`changelogFromRoot` plugin that copies the root changelog to `docs/` and
all `versioned_docs/` at build time
- Remove versioned changelog snapshots from git tracking (gitignored,
same as SDK/client repos)
- Update release workflow to exclude changelog from version snapshots
- The current workflow doesn't work anyway

---

Co-authored-by: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

Author: vdusek

.github/workflows/manual_release_stable.yaml

@@ -157,12 +157,13 @@ jobs:
           rm -rf "versioned_docs/version-${MAJOR_MINOR}"
           rm -rf "versioned_sidebars/version-${MAJOR_MINOR}-sidebars.json"
           jq 'map(select(. != env.MAJOR_MINOR))' versions.json > tmp.json && mv tmp.json versions.json
-          # Copy changelog
-          cp ../CHANGELOG.md ../docs/changelog.md
           # Build API reference and create version snapshots
           bash build_api_reference.sh
           npx docusaurus docs:version "$MAJOR_MINOR"
           npx docusaurus api:version "$MAJOR_MINOR"
+          # Changelog is not versioned - it is copied from root at build time
+          rm -f "versioned_docs/version-${MAJOR_MINOR}/changelog.md"
+          echo "changelog.md" > "versioned_docs/version-${MAJOR_MINOR}/.gitignore"
 
       - name: Commit and push versioned docs
         id: commit_versioned_docs

website/docusaurus.config.js

@@ -1,5 +1,6 @@
 /* eslint-disable global-require */
-const path = require('path');
+const fs = require('node:fs');
+const path = require('node:path');
 
 const { externalLinkProcessor } = require('./tools/utils/externalLink');
 
@@ -232,6 +233,35 @@ module.exports = {
                 },
             };
         },
+        // Copy root CHANGELOG.md to docs/ and all versioned_docs/ so every
+        // doc version displays the same (latest) changelog — not a snapshot.
+        function changelogFromRoot() {
+            const sourceChangelog = path.join(__dirname, '..', 'CHANGELOG.md');
+            return {
+                name: 'changelog-from-root',
+                async loadContent() {
+                    if (!fs.existsSync(sourceChangelog)) return;
+
+                    const changelog = fs.readFileSync(sourceChangelog, 'utf-8');
+                    const docsDir = path.join(__dirname, '..', 'docs');
+                    const versionedDocsDir = path.join(__dirname, 'versioned_docs');
+
+                    const targetDirs = [docsDir];
+                    if (fs.existsSync(versionedDocsDir)) {
+                        for (const version of fs.readdirSync(versionedDocsDir)) {
+                            targetDirs.push(path.join(versionedDocsDir, version));
+                        }
+                    }
+
+                    for (const dir of targetDirs) {
+                        fs.writeFileSync(path.join(dir, 'changelog.md'), changelog);
+                    }
+                },
+                getPathsToWatch() {
+                    return [sourceChangelog];
+                },
+            };
+        },
         [
             path.resolve(__dirname, 'src/plugins/docusaurus-plugin-segment'),
             {

website/package.json

@@ -3,9 +3,9 @@
     "scripts": {
         "examples": "docusaurus-examples",
         "postinstall": "npx patch-package",
-        "start": "rimraf .docusaurus && cp ../CHANGELOG.md ../docs/changelog.md && docusaurus start",
-        "start:fast": "rimraf .docusaurus && cp ../CHANGELOG.md ../docs/changelog.md && CRAWLEE_DOCS_FAST=1 docusaurus start",
-        "build": "rimraf .docusaurus && cp ../CHANGELOG.md ../docs/changelog.md && node --max_old_space_size=16000 node_modules/@docusaurus/core/bin/docusaurus.mjs build",
+        "start": "rimraf .docusaurus && docusaurus start",
+        "start:fast": "rimraf .docusaurus && CRAWLEE_DOCS_FAST=1 docusaurus start",
+        "build": "rimraf .docusaurus && node --max_old_space_size=16000 node_modules/@docusaurus/core/bin/docusaurus.mjs build",
         "publish-gh-pages": "docusaurus-publish",
         "write-translations": "docusaurus write-translations",
         "version": "docusaurus version",

website/versioned_docs/version-0.6/.gitignore

@@ -0,0 +1 @@
+changelog.md