Skip to content

[chore](docs) Archive legacy sources and update PDF download URLs - #4569

Open
morningman wants to merge 1 commit into
apache:masterfrom
morningman:chore/archive-legacy-doc-sources
Open

morningman wants to merge 1 commit into
apache:masterfrom
morningman:chore/archive-legacy-doc-sources

Conversation

@morningman

Copy link
Copy Markdown
Contributor

Summary

Versions 2.1, 2.0, and 1.2 are already archived as PDFs, but their sources still appear beside maintained documentation. Move their English and Chinese sources, sidebars, and translation metadata into archived_docs/, preserving the original relative directory structure. All 5,882 moved files are unchanged.

Update source discovery so historical redirects and local PDF exports continue to work. Remove archived-version imports from the legacy build script, exclude frozen snapshots from the changed-file link checker, and limit the global link checker to active versions. Document the archive boundary in the contributor instructions.

Change the archive page's PDF download prefix to https://apache-doris-releases.oss-accelerate.aliyuncs.com/archived-docs/.

Validation

  • node --test scripts/archive-docs/archive.test.cjs scripts/docs-pdf/docs-pdf.test.cjs scripts/check_move.test.js scripts/i18n/__tests__/active-doc-versions.test.cjs
  • PYTHONDONTWRITEBYTECODE=1 python3 -m unittest discover -s .github/scripts -p test_pr_gates.py -v
  • Compared SHA-256 hashes for all 5,882 moved files and verified that all six ordered source inventories and historical routes match the original snapshots.
  • Rendered the archive page and checked all six download URLs; each PDF URL returns HTTP 200.
  • Loaded the Docusaurus configuration and checked shell/Python syntax and diff whitespace.

A full site build was not run locally. Active documentation versions and public documentation routes are unchanged.

Versions

  • dev
  • 4.x
  • 3.x
  • 2.1 or older (not covered by version/language sync gate)

Languages

  • Chinese
  • English

Docs Checklist

  • Checked by AI
  • Test Cases Built
  • Updated required version and language counterparts, or explained why not
  • If only one language changed, confirmed whether source/translation counterparts need sync (both languages move together)

This branch has not been deployed

No deployments
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.

1 participant