Skip to content

Conversation

@ebembi-crdb
Copy link
Contributor

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

Changes

  • Added deprecation notice to releases/v20.2.md
  • Removed v20.2 release notes and sidebar data
  • Added v20.2 to .htmltest.yml IgnoreDirs
  • Updated sidebar_htmltest.rb to respect htmltest config
  • Removed LLM-generated openssl_fix.rb and debug files (error.log, output.txt)

ebembi-crdb added 2 commits November 25, 2025 17:17
- Remove LLM-generated openssl_fix.rb script
- Remove debug files (error.log, output.txt)
- Update sidebar_htmltest.rb to respect htmltest config and skip archived versions

This addresses issues similar to those found in PR #21195 for v2.1:
- Removes SSL workaround script that doesn't belong in src/current
- Removes accidentally committed build artifacts
- Ensures htmltest skips archived versions during validation
@ebembi-crdb ebembi-crdb requested a review from a team as a code owner December 1, 2025 14:48
@netlify
Copy link

netlify bot commented Dec 1, 2025

Deploy Preview for cockroachdb-interactivetutorials-docs canceled.

Name Link
🔨 Latest commit bc99264
🔍 Latest deploy log https://app.netlify.com/projects/cockroachdb-interactivetutorials-docs/deploys/694963bd580c950008cb6c75

@netlify
Copy link

netlify bot commented Dec 1, 2025

Deploy Preview for cockroachdb-api-docs canceled.

Name Link
🔨 Latest commit bc99264
🔍 Latest deploy log https://app.netlify.com/projects/cockroachdb-api-docs/deploys/694963bdc3312900089e88df

@github-actions
Copy link

github-actions bot commented Dec 1, 2025

Files changed:

  • src/current/Gemfile
  • src/current/_includes/releases/v20.2/v20.2.0-alpha.1.md:
  • src/current/_includes/releases/v20.2/v20.2.0-alpha.2.md:
  • src/current/_includes/releases/v20.2/v20.2.0-alpha.3.md:
  • src/current/_includes/releases/v20.2/v20.2.0-beta.1.md:
  • src/current/_includes/releases/v20.2/v20.2.0-beta.2.md:
  • src/current/_includes/releases/v20.2/v20.2.0-beta.3.md:
  • src/current/_includes/releases/v20.2/v20.2.0-beta.4.md:
  • src/current/_includes/releases/v20.2/v20.2.0-rc.1.md:
  • src/current/_includes/releases/v20.2/v20.2.0-rc.2.md:
  • src/current/_includes/releases/v20.2/v20.2.0-rc.3.md:
  • src/current/_includes/releases/v20.2/v20.2.0-rc.4.md:
  • src/current/_includes/releases/v20.2/v20.2.0.md:
  • src/current/_includes/releases/v20.2/v20.2.1.md:
  • src/current/_includes/releases/v20.2/v20.2.10.md:
  • src/current/_includes/releases/v20.2/v20.2.11.md:
  • src/current/_includes/releases/v20.2/v20.2.12.md:
  • src/current/_includes/releases/v20.2/v20.2.13.md:
  • src/current/_includes/releases/v20.2/v20.2.14.md:
  • src/current/_includes/releases/v20.2/v20.2.15.md:
  • src/current/_includes/releases/v20.2/v20.2.16.md:
  • src/current/_includes/releases/v20.2/v20.2.17.md:
  • src/current/_includes/releases/v20.2/v20.2.18.md:
  • src/current/_includes/releases/v20.2/v20.2.19.md:
  • src/current/_includes/releases/v20.2/v20.2.2.md:
  • src/current/_includes/releases/v20.2/v20.2.3.md:
  • src/current/_includes/releases/v20.2/v20.2.4.md:
  • src/current/_includes/releases/v20.2/v20.2.5.md:
  • src/current/_includes/releases/v20.2/v20.2.6.md:
  • src/current/_includes/releases/v20.2/v20.2.7.md:
  • src/current/_includes/releases/v20.2/v20.2.8.md:
  • src/current/_includes/releases/v20.2/v20.2.9.md:
  • src/current/_includes/sidebar-data-v20.2.json
  • src/current/_includes/v23.1/sql/replication-zone-patterns-to-multiregion-sql-mapping.md:
  • src/current/_includes/v23.2/sql/replication-zone-patterns-to-multiregion-sql-mapping.md:
  • src/current/_includes/v24.1/sql/replication-zone-patterns-to-multiregion-sql-mapping.md:
  • src/current/_includes/v24.2/sql/replication-zone-patterns-to-multiregion-sql-mapping.md:
  • src/current/_includes/v24.3/sql/replication-zone-patterns-to-multiregion-sql-mapping.md:
  • src/current/_includes/v25.1/sql/replication-zone-patterns-to-multiregion-sql-mapping.md:
  • src/current/_includes/v25.2/sql/replication-zone-patterns-to-multiregion-sql-mapping.md:
  • src/current/_includes/v25.3/sql/replication-zone-patterns-to-multiregion-sql-mapping.md:
  • src/current/_includes/v25.4/sql/replication-zone-patterns-to-multiregion-sql-mapping.md:
  • src/current/_includes/v26.1/sql/replication-zone-patterns-to-multiregion-sql-mapping.md:
  • src/current/images/v20.2/CockroachDB_Training_Wide.png:
    • Warning: include not used in any v26.1 file or include
  • src/current/images/v20.2/Parallel_Statement_Execution_Error_Mismatch.png:
    • Warning: include not used in any v26.1 file or include
  • src/current/images/v20.2/Parallel_Statement_Hybrid_Execution.png:
    • Warning: include not used in any v26.1 file or include
  • src/current/images/v20.2/Parallel_Statement_Normal_Execution.png:
    • Warning: include not used in any v26.1 file or include
  • src/current/images/v20.2/Sequential_Statement_Execution.png:
    • Warning: include not used in any v26.1 file or include
  • src/current/images/v20.2/after-decommission1.png:
    • Warning: include not used in any v26.1 file or include
  • src/current/images/v20.2/after-decommission2.png:
    • Warning: include not used in any v26.1 file or include
  • src/current/images/v20.2/automated-operations1.png:
    • Warning: include not used in any v26.1 file or include
  • src/current/images/v20.2/before-decommission0.png:
    • Warning: include not used in any v26.1 file or include
  • src/current/images/v20.2/before-decommission1.png:
    • Warning: include not used in any v26.1 file or include
  • src/current/images/v20.2/before-decommission2.png:
    • Warning: include not used in any v26.1 file or include
  • src/current/images/v20.2/cloudformation_admin_ui_live_node_count.png:
    • Warning: include not used in any v26.1 file or include
  • src/current/images/v20.2/cloudformation_admin_ui_replicas.png:
    • Warning: include not used in any v26.1 file or include
  • src/current/images/v20.2/cloudformation_admin_ui_sql_queries.png:
    • Warning: include not used in any v26.1 file or include
  • src/current/images/v20.2/cluster-status-after-decommission1.png:
    • Warning: include not used in any v26.1 file or include
  • src/current/images/v20.2/cluster-status-after-decommission2.png:
    • Warning: include not used in any v26.1 file or include
  • src/current/images/v20.2/concurrency.png:
    • Warning: include not used in any v26.1 file or include
  • src/current/images/v20.2/dbeaver-01-select-cockroachdb.png:
  • src/current/images/v20.2/dbeaver-02-cockroachdb-connection-settings.png:
  • src/current/images/v20.2/dbeaver-03-ssl-tab.png:
  • src/current/images/v20.2/dbeaver-04-connection-success-dialog.png:
  • src/current/images/v20.2/dbeaver-05-movr.png:
  • src/current/images/v20.2/decommission-multiple1.png:
    • Warning: include not used in any v26.1 file or include
  • src/current/images/v20.2/decommission-multiple2.png:
    • Warning: include not used in any v26.1 file or include
  • src/current/images/v20.2/decommission-multiple3.png:
    • Warning: include not used in any v26.1 file or include
  • src/current/images/v20.2/decommission-multiple4.png:
    • Warning: include not used in any v26.1 file or include
  • src/current/images/v20.2/decommission-multiple5.png:
    • Warning: include not used in any v26.1 file or include
  • src/current/images/v20.2/decommission-multiple6.png:
    • Warning: include not used in any v26.1 file or include
  • src/current/images/v20.2/decommission-multiple7.png:
    • Warning: include not used in any v26.1 file or include
  • src/current/images/v20.2/decommission-scenario1.1.png:
  • src/current/images/v20.2/decommission-scenario1.2.png:
  • src/current/images/v20.2/decommission-scenario1.3.png:
  • src/current/images/v20.2/decommission-scenario2.1.png:
  • src/current/images/v20.2/decommission-scenario2.2.png:
  • src/current/images/v20.2/decommission-scenario3.1.png:
    • Warning: include not used in any v26.1 file or include
  • src/current/images/v20.2/decommission-scenario3.2.png:
    • Warning: include not used in any v26.1 file or include
  • src/current/images/v20.2/decommission-scenario3.3.png:
    • Warning: include not used in any v26.1 file or include
  • src/current/images/v20.2/explain-analyze-distsql-plan.png:
    • Warning: include not used in any v26.1 file or include
  • src/current/images/v20.2/explain-distsql-plan.png:
  • src/current/images/v20.2/explain-distsql-types-plan.png:
  • src/current/images/v20.2/fault-tolerance-1.png:
  • src/current/images/v20.2/fault-tolerance-2.png:
  • src/current/images/v20.2/fault-tolerance-3.png:
  • src/current/images/v20.2/fault-tolerance-4.png:
  • src/current/images/v20.2/fault-tolerance-5.png:
  • src/current/images/v20.2/fault-tolerance-6.png:
  • src/current/images/v20.2/fault-tolerance-7.png:
  • src/current/images/v20.2/fault-tolerance-8.png:
  • src/current/images/v20.2/fault-tolerance-9.png:
  • src/current/images/v20.2/follow-workload-1.png:
    • Warning: include not used in any v26.1 file or include
  • src/current/images/v20.2/follow-workload-2.png:
    • Warning: include not used in any v26.1 file or include
  • src/current/images/v20.2/follow-workload-network-latency.png:
    • Warning: include not used in any v26.1 file or include
  • src/current/images/v20.2/geo-partitioning-cluster-topology.png:
    • Warning: include not used in any v26.1 file or include
  • src/current/images/v20.2/geo-partitioning-network-latency.png:
  • src/current/images/v20.2/geo-partitioning-node-map-1.png:
    • Warning: include not used in any v26.1 file or include
  • src/current/images/v20.2/geo-partitioning-node-map-2.png:
    • Warning: include not used in any v26.1 file or include
  • src/current/images/v20.2/geo-partitioning-node-map-3.png:
    • Warning: include not used in any v26.1 file or include

@netlify
Copy link

netlify bot commented Dec 1, 2025

Netlify Preview

Name Link
🔨 Latest commit bc99264
🔍 Latest deploy log https://app.netlify.com/projects/cockroachdb-docs/deploys/694963bd6090380008297b07
😎 Deploy Preview https://deploy-preview-21403--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.

This LGTM modulo the duplicate changes to gemfile and HTMLTest which can be removed. If you merge #21195
and #21416 this should easily go in after those 2

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.

gemfile changes should go in a separate PR

@site = site

# Read htmltest configuration to get ignored directories
htmltest_config = YAML.load_file('.htmltest.yml') rescue {}
Copy link
Contributor

Choose a reason for hiding this comment

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

this is duplicated from #21195 and #21416 - please merge those PRs and rebase, this should go away

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 11 commits December 22, 2025 16:56
- Add v20.2 offline documentation link to archived documentation page
- Remove v20.2 specific files from repository including:
  - src/current/v20.2/ directory
  - src/current/_includes/sidebar-data-v20.2.json
  - src/current/images/v20.2/ directory
- Resolve merge conflicts with main branch
- Revert Gemfile changes per review feedback
The build requires jekyll-minifier gem. Will be removed in separate PR as requested in review.
- Resolved merge conflicts in archived-documentation.md
- Removed v20.2/cockroach-start.md (archiving v20.2)
- Fixed broken links to v20.2 topology documentation
- Resolved merge conflicts by confirming deletion of v20.2 files
- Fixed broken v20.2 geospatial image references by updating to each version's own images
- Preserved v21.1 documentation files on this branch
- Updated archived-documentation.md to include both v21.1 and v20.2
Add missing destination-file-privileges.md include file for v21.1
by copying from v21.2 to fix build error
Resolved conflicts by:
- Keeping v21.2 documentation files on this branch (only archiving v20.2)
- Not adding v21.2 to archived-documentation.md (v21.2 still active on this branch)
- Accepting deletion of v21.2 release include files from main
Add missing diagram files for v21.1 documentation:
- backup.html
- restore.html

These files are required by v21.1/backup.md and v21.1/restore.md
Copied from v20.2/sql/diagrams to v21.1/sql/generated/diagrams
v21.1 was already archived on main, so it should also be deleted on
this branch to avoid build failures. This replaces the incorrect
approach of creating missing v21.1 includes.

Following the proper archival pattern from successful PRs:
- Delete ALL files for archived versions
- Don't patch other versions with missing includes
v21.2 was already archived on main, so it should also be deleted on
this branch to avoid build failures with missing includes.

Following the proper archival pattern:
- Delete ALL files for archived versions
- Don't patch other versions with missing includes
Resolved merge conflicts:
- Deleted v22.2 files that were already archived on main
- Updated archived-documentation.md to include v22.2 and v21.2 entries
- Deleted v21.2 files to avoid build failures (already archived on main)
Resolved merge conflicts:
- Deleted v22.1 files that were already archived on main
- Removed conflicting v22.1 includes and documentation files
@ebembi-crdb ebembi-crdb merged commit f89fca4 into main Dec 22, 2025
5 checks passed
@ebembi-crdb ebembi-crdb deleted the archive-v20.2 branch December 22, 2025 15:36
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