Skip to content

Conversation

@ebembi-crdb
Copy link
Contributor

Archives v21.2 documentation following the same process used for v2.1.

ebembi-crdb added 8 commits November 26, 2025 21:59
This release is no longer supported. See https://www.cockroachlabs.com/docs/releases/release-support-policy.html

* Delete entire v21.2 directory (700+ files)
* Delete sidebar-data-v21.2.json
* Delete _includes/releases/v21.2/ directory (26 releases)
* Delete _includes/v21.2/ directory (400+ includes)
* Update releases/v21.2.md with anchor tags for all releases
* Fix cross-version references in backup documentation (v23.1-v25.4)
* Fix cross-version references in orchestration includes (v22.1-v22.2)
* Fix cross-version references in advisory documentation
- Fix remaining 5 v21.2 HTML links in v22.1 files
- All Jekyll builds and htmltest now pass (9,163 documents tested)
- Archive follows established v2.1 pattern: sidebar data deleted, includes removed, release page archived
- Cross-version reference cleanup complete across v22.1-v25.4
- Remove LLM-generated openssl_fix.rb script
- Remove debug file output.txt
- Update sidebar_htmltest.rb to respect htmltest config and skip archived versions
@ebembi-crdb ebembi-crdb requested a review from a team as a code owner December 1, 2025 15:23
@github-actions
Copy link

github-actions bot commented Dec 1, 2025

Files changed:

  • src/current/Gemfile
  • src/current/_includes/releases/v21.2/v21.2.0-beta.1.md:
  • src/current/_includes/releases/v21.2/v21.2.0-beta.2.md:
  • src/current/_includes/releases/v21.2/v21.2.0-beta.3.md:
  • src/current/_includes/releases/v21.2/v21.2.0-beta.4.md:
  • src/current/_includes/releases/v21.2/v21.2.0-rc.1.md:
  • src/current/_includes/releases/v21.2/v21.2.0-rc.2.md:
  • src/current/_includes/releases/v21.2/v21.2.0-rc.3.md:
  • src/current/_includes/releases/v21.2/v21.2.0.md:
  • src/current/_includes/releases/v21.2/v21.2.1.md:
  • src/current/_includes/releases/v21.2/v21.2.10.md:
  • src/current/_includes/releases/v21.2/v21.2.11.md:
  • src/current/_includes/releases/v21.2/v21.2.12.md:
  • src/current/_includes/releases/v21.2/v21.2.13.md:
  • src/current/_includes/releases/v21.2/v21.2.14.md:
  • src/current/_includes/releases/v21.2/v21.2.15.md:
  • src/current/_includes/releases/v21.2/v21.2.16.md:
  • src/current/_includes/releases/v21.2/v21.2.17.md:
  • src/current/_includes/releases/v21.2/v21.2.2.md:
  • src/current/_includes/releases/v21.2/v21.2.3.md:
  • src/current/_includes/releases/v21.2/v21.2.4.md:
  • src/current/_includes/releases/v21.2/v21.2.5.md:
  • src/current/_includes/releases/v21.2/v21.2.6.md:
  • src/current/_includes/releases/v21.2/v21.2.7.md:
  • src/current/_includes/releases/v21.2/v21.2.8.md:
  • src/current/_includes/releases/v21.2/v21.2.9.md:
  • src/current/_includes/releases/v23.1/v23.1.9.md:
  • src/current/_includes/sidebar-data-v21.2.json
  • src/current/_includes/v21.2/app/before-you-begin.md:
    • Warning: include not used in any v21.2 file or include
  • src/current/_includes/v21.2/app/cc-free-tier-params.md:
    • Warning: include not used in any v21.2 file or include
  • src/current/_includes/v21.2/app/create-a-database.md:
    • Warning: include not used in any v21.2 file or include
  • src/current/_includes/v21.2/app/create-maxroach-user-and-bank-database.md:
    • Warning: include not used in any v21.2 file or include
  • src/current/_includes/v21.2/app/for-a-complete-example-go.md:
    • Warning: include not used in any v21.2 file or include
  • src/current/_includes/v21.2/app/for-a-complete-example-java.md:
    • Warning: include not used in any v21.2 file or include
  • src/current/_includes/v21.2/app/for-a-complete-example-python.md:
    • Warning: include not used in any v21.2 file or include
  • src/current/_includes/v21.2/app/hibernate-dialects-note.md:
    • Warning: include not used in any v21.2 file or include
  • src/current/_includes/v21.2/app/insecure/create-maxroach-user-and-bank-database.md:
    • Warning: include not used in any v21.2 file or include
  • src/current/_includes/v21.2/app/insecure/jooq-basic-sample/Sample.java:
    • Warning: include not used in any v21.2 file or include
  • src/current/_includes/v21.2/app/insecure/jooq-basic-sample/jooq-basic-sample.zip:
    • Warning: include not used in any v21.2 file or include
  • src/current/_includes/v21.2/app/insecure/upperdb-basic-sample/main.go:
    • Warning: include not used in any v21.2 file or include
  • src/current/_includes/v21.2/app/java-tls-note.md:
    • Warning: include not used in any v21.2 file or include
  • src/current/_includes/v21.2/app/java-version-note.md:
    • Warning: include not used in any v21.2 file or include
  • src/current/_includes/v21.2/app/jooq-basic-sample/Sample.java:
    • Warning: include not used in any v21.2 file or include
  • src/current/_includes/v21.2/app/jooq-basic-sample/jooq-basic-sample.zip:
    • Warning: include not used in any v21.2 file or include
  • src/current/_includes/v21.2/app/pkcs8-gen.md:
    • Warning: include not used in any v21.2 file or include
  • src/current/_includes/v21.2/app/python/sqlalchemy/sqlalchemy-large-txns.py:
    • Warning: include not used in any v21.2 file or include
  • src/current/_includes/v21.2/app/retry-errors.md:
    • Warning: include not used in any v21.2 file or include
  • src/current/_includes/v21.2/app/sample-setup.md:
    • Warning: include not used in any v21.2 file or include
  • src/current/_includes/v21.2/app/see-also-links.md:
    • Warning: include not used in any v21.2 file or include
  • src/current/_includes/v21.2/app/start-cockroachdb.md:
    • Warning: include not used in any v21.2 file or include
  • src/current/_includes/v21.2/app/upperdb-basic-sample/main.go:
    • Warning: include not used in any v21.2 file or include
  • src/current/_includes/v21.2/backups/advanced-examples-list.md:
    • Warning: include not used in any v21.2 file or include
  • src/current/_includes/v21.2/backups/aws-auth-note.md:
    • Warning: include not used in any v21.2 file or include
  • src/current/_includes/v21.2/backups/backup-options.md:
    • Warning: include not used in any v21.2 file or include
  • src/current/_includes/v21.2/backups/bulk-auth-options.md:
    • Warning: include not used in any v21.2 file or include
  • src/current/_includes/v21.2/backups/destination-file-privileges.md:
    • Warning: include not used in any v21.2 file or include
  • src/current/_includes/v21.2/backups/encrypted-backup-description.md:
    • Warning: include not used in any v21.2 file or include
  • src/current/_includes/v21.2/backups/file-size-setting.md:
    • Warning: include not used in any v21.2 file or include
  • src/current/_includes/v21.2/backups/gcs-auth-note.md:
    • Warning: include not used in any v21.2 file or include
  • src/current/_includes/v21.2/backups/gcs-default-deprec.md:
    • Warning: include not used in any v21.2 file or include
  • src/current/_includes/v21.2/backups/no-incremental-restore.md:
    • Warning: include not used in any v21.2 file or include
  • src/current/_includes/v21.2/cdc/avro-limitations.md:
    • Warning: include not used in any v21.2 file or include
  • src/current/_includes/v21.2/cdc/client-key-encryption.md:
    • Warning: include not used in any v21.2 file or include
  • src/current/_includes/v21.2/cdc/configure-all-changefeed.md:
    • Warning: include not used in any v21.2 file or include
  • src/current/_includes/v21.2/cdc/confluent-cloud-sr-url.md:
    • Warning: include not used in any v21.2 file or include
  • src/current/_includes/v21.2/cdc/core-csv.md:
    • Warning: include not used in any v21.2 file or include
  • src/current/_includes/v21.2/cdc/core-url.md:
    • Warning: include not used in any v21.2 file or include
  • src/current/_includes/v21.2/cdc/create-core-changefeed-avro.md:
    • Warning: include not used in any v21.2 file or include
  • src/current/_includes/v21.2/cdc/create-core-changefeed.md:
    • Warning: include not used in any v21.2 file or include
  • src/current/_includes/v21.2/cdc/create-example-db-cdc.md:
    • Warning: include not used in any v21.2 file or include
  • src/current/_includes/v21.2/cdc/external-urls.md:
    • Warning: include not used in any v21.2 file or include
  • src/current/_includes/v21.2/cdc/metrics-labels.md:
    • Warning: include not used in any v21.2 file or include
  • src/current/_includes/v21.2/cdc/options-table-note.md:
    • Warning: include not used in any v21.2 file or include
  • src/current/_includes/v21.2/cdc/print-key.md:
    • Warning: include not used in any v21.2 file or include
  • src/current/_includes/v21.2/cdc/sql-cluster-settings-example.md:
    • Warning: include not used in any v21.2 file or include
  • src/current/_includes/v21.2/cdc/url-encoding.md:
    • Warning: include not used in any v21.2 file or include
  • src/current/_includes/v21.2/cdc/webhook-beta.md:
    • Warning: include not used in any v21.2 file or include
  • src/current/_includes/v21.2/client-transaction-retry.md:
    • Warning: include not used in any v21.2 file or include
  • src/current/_includes/v21.2/computed-columns/add-computed-column.md:
    • Warning: include not used in any v21.2 file or include
  • src/current/_includes/v21.2/computed-columns/alter-computed-column.md:
    • Warning: include not used in any v21.2 file or include
  • src/current/_includes/v21.2/computed-columns/convert-computed-column.md:
    • Warning: include not used in any v21.2 file or include
  • src/current/_includes/v21.2/computed-columns/jsonb.md:
    • Warning: include not used in any v21.2 file or include
  • src/current/_includes/v21.2/computed-columns/secondary-index.md:
    • Warning: include not used in any v21.2 file or include
  • src/current/_includes/v21.2/computed-columns/simple.md:
    • Warning: include not used in any v21.2 file or include
  • src/current/_includes/v21.2/computed-columns/virtual.md:
    • Warning: include not used in any v21.2 file or include
  • src/current/_includes/v21.2/demo_movr.md:
    • Warning: include not used in any v21.2 file or include
  • src/current/_includes/v21.2/faq/auto-generate-unique-ids.html:
    • Warning: include not used in any v21.2 file or include
  • src/current/_includes/v21.2/faq/clock-synchronization-effects.md:
    • Warning: include not used in any v21.2 file or include
  • src/current/_includes/v21.2/faq/clock-synchronization-monitoring.html:
    • Warning: include not used in any v21.2 file or include
  • src/current/_includes/v21.2/faq/differences-between-numberings.md:
    • Warning: include not used in any v21.2 file or include
  • src/current/_includes/v21.2/faq/sequential-numbers.md:
    • Warning: include not used in any v21.2 file or include
  • src/current/_includes/v21.2/faq/sequential-transactions.md:
    • Warning: include not used in any v21.2 file or include
  • src/current/_includes/v21.2/faq/simulate-key-value-store.html:
    • Warning: include not used in any v21.2 file or include
  • src/current/_includes/v21.2/filter-tabs/crdb-kubernetes.md:
    • Warning: include not used in any v21.2 file or include
  • src/current/_includes/v21.2/filter-tabs/crdb-single-kubernetes.md:
    • Warning: include not used in any v21.2 file or include
  • src/current/_includes/v21.2/filter-tabs/crud-go.md:
    • Warning: include not used in any v21.2 file or include
  • src/current/_includes/v21.2/filter-tabs/crud-java.md:
    • Warning: include not used in any v21.2 file or include
  • src/current/_includes/v21.2/filter-tabs/crud-js.md:
    • Warning: include not used in any v21.2 file or include
  • src/current/_includes/v21.2/filter-tabs/crud-python.md:
    • Warning: include not used in any v21.2 file or include
  • src/current/_includes/v21.2/filter-tabs/crud-ruby.md:
    • Warning: include not used in any v21.2 file or include

@netlify
Copy link

netlify bot commented Dec 1, 2025

Deploy Preview for cockroachdb-interactivetutorials-docs canceled.

Name Link
🔨 Latest commit 0bdd215
🔍 Latest deploy log https://app.netlify.com/projects/cockroachdb-interactivetutorials-docs/deploys/692db4a297ccfc0008a49aeb

@netlify
Copy link

netlify bot commented Dec 1, 2025

Deploy Preview for cockroachdb-api-docs canceled.

Name Link
🔨 Latest commit 0bdd215
🔍 Latest deploy log https://app.netlify.com/projects/cockroachdb-api-docs/deploys/692db4a276d99100089a754d

@netlify
Copy link

netlify bot commented Dec 1, 2025

Netlify Preview

Name Link
🔨 Latest commit b91d249
🔍 Latest deploy log https://app.netlify.com/projects/cockroachdb-docs/deploys/692db2fa007f810008e34fe1
😎 Deploy Preview https://deploy-preview-21418--cockroachdb-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.

@netlify
Copy link

netlify bot commented Dec 1, 2025

Netlify Preview

Name Link
🔨 Latest commit 0bdd215
🔍 Latest deploy log https://app.netlify.com/projects/cockroachdb-docs/deploys/692db4a2e80ead00084d4276
😎 Deploy Preview https://deploy-preview-21418--cockroachdb-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.

Copy link
Contributor

@rmloveland rmloveland left a comment

Choose a reason for hiding this comment

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

needs a couple changes but should go in easily after #21417

@@ -6,7 +6,7 @@

Therefore, in order to upgrade to {{ page.version.version }}, you must be on a production release of {{ previous_version }}.

1. If you are upgrading to {{ page.version.version }} from a production release earlier than {{ previous_version }}, or from a testing release (alpha/beta), first [upgrade to a production release of {{ previous_version }}]({% link {{ previous_version }}/upgrade-cockroachdb-kubernetes.md %}?filters=helm). Be sure to complete all the steps.
1. If you are upgrading to {{ page.version.version }} from a production release earlier than {{ previous_version }}, or from a testing release (alpha/beta), first upgrade to a production release of {{ previous_version }}. Be sure to complete all the steps.
Copy link
Contributor

Choose a reason for hiding this comment

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

i have a feeling these changes outside of v21.2 will conflict with similar changes i saw in the previous PR #21417, but once that one goes in rebasing this and fixing any conflicts should be easy


module SidebarHTMLTest
class Generator < Jekyll::Generator
def generate(site)
@site = site

# Read htmltest configuration to get ignored directories
Copy link
Contributor

Choose a reason for hiding this comment

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

i think all of these will conflict with this same edit in #21195 but should be an easy fix if we merge them in order

gem "webrick"
gem "jekyll-minifier"

gem "csv"
Copy link
Contributor

Choose a reason for hiding this comment

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

should be separate docs infra PR, in fact this may already be fixed on main

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