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/_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
  • src/current/_includes/v21.2/filter-tabs/crud-spring.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 2b3dba4
🔍 Latest deploy log https://app.netlify.com/projects/cockroachdb-interactivetutorials-docs/deploys/6949490c0a865300084857a2

@netlify
Copy link

netlify bot commented Dec 1, 2025

Deploy Preview for cockroachdb-api-docs canceled.

Name Link
🔨 Latest commit 2b3dba4
🔍 Latest deploy log https://app.netlify.com/projects/cockroachdb-api-docs/deploys/6949490cb77b240008c62f22

@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 2b3dba4
🔍 Latest deploy log https://app.netlify.com/projects/cockroachdb-docs/deploys/6949490c32fc5a000829cc2e
😎 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

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.

@ebembi-crdb this LGTM once you implement the changes I mentioned in the comments. Wanted to unblock you on this since I will be on PTO for the holidays next week

ebembi-crdb added 3 commits December 22, 2025 17:46
- Add v21.2 offline documentation link to archived documentation page
- Remove v21.2 specific files from repository
- Keep Gemfile with jekyll-minifier for build
- Fix kubernetes-upgrade-cluster-helm.md link
- Resolve merge conflicts with main branch
Remove link to v21.2/take-full-and-incremental-backups.md which no longer
exists since v21.2 documentation has been archived
- Fixed broken v21.2 storage layer image references by updating each version
  to use its own images (sst.png, lsm-with-ssts.png, memtable-wal-sst.png)
- Resolved merge conflicts by confirming deletion of v21.2 files
- Updated archived-documentation.md to include both v21.2 and v19.2
@ebembi-crdb ebembi-crdb merged commit 2356da0 into main Dec 22, 2025
5 checks passed
@ebembi-crdb ebembi-crdb deleted the archive-v21.2 branch December 22, 2025 13:53
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