Create public preview docs for new Kubernetes operator

[jhlodin]

TODO:

• Add public preview notice to all new pages
• Audit for includes (new/adding to existing)
• Set up liquid variables for product names
• Write content for introduction page
• Cross-reference new operator content from existing k8s content
• Cover flagTemplate/podTemplate https://cockroachlabs.atlassian.net/browse/CRDB-52096
• Add rollback to migration guide [CRDB-48576] Add rollback steps if migration fails from helm and operator helm-charts#542

REQUEST FOR REVIEW

• Need a peer review of the written content (assume technical accuracy for now)
• Some additional content is expected, no anticipated removal of major changes to current content.
• Looking for suggestions on making the code blocks nicer, particularly the ones that contain multiple commands where the shell syntax highlighting is unhelpful (only the first line gets a $ prompt, all other lines with prompts are ignored)

[github-actions]

Files changed:

• src/current/_includes/v25.2/sidebar-data/self-hosted-deployments.json
• src/current/v25.2/configure-cockroachdb-kubernetes-operator.md
• src/current/v25.2/deploy-cockroachdb-with-kubernetes-operator.md
• src/current/v25.2/kubernetes-operator-overview.md
• src/current/v25.2/kubernetes-operator-performance.md
• src/current/v25.2/migrate-cockroachdb-kubernetes-helm.md
• src/current/v25.2/migrate-cockroachdb-kubernetes-operator.md
• src/current/v25.2/monitor-cockroachdb-kubernetes-operator.md
• src/current/v25.2/scale-cockroachdb-kubernetes-operator.md
• src/current/v25.2/schedule-cockroachdb-kubernetes-operator.md
• src/current/v25.2/secure-cockroachdb-kubernetes-operator.md
• src/current/v25.2/upgrade-cockroachdb-kubernetes-operator.md

[netlify]

✅ Deploy Preview for cockroachdb-interactivetutorials-docs canceled.

Name	Link
🔨 Latest commit	739c828
🔍 Latest deploy log	https://app.netlify.com/projects/cockroachdb-interactivetutorials-docs/deploys/688db49598a3e50008fe524e

[netlify]

✅ Deploy Preview for cockroachdb-api-docs canceled.

Name	Link
🔨 Latest commit	739c828
🔍 Latest deploy log	https://app.netlify.com/projects/cockroachdb-api-docs/deploys/688db495275ce9000852ae98

[jhlodin]

This is not rendering like it should, unsure why. The needed version of the include content can be found here: https://docs.google.com/document/d/196HI1b1QSbyDGtLPT3FF8rbNeMVdOZBCMyQ7UKdbK8k/edit?tab=t.k5y17crpdkaz#heading=h.144douprth3q

@mikeCRL can you take a look?

[netlify]

❌ Deploy Preview for cockroachdb-docs failed. Why did it fail? →

Name	Link
🔨 Latest commit	739c828
🔍 Latest deploy log	https://app.netlify.com/projects/cockroachdb-docs/deploys/688db4954256a80008253bec

[taroface]

This is quite a lot of work -- apologies for taking a while on the review.

I have a lot of suggested edits here, but am blocking for the following:

• (Obviously, as you mentioned) Still needs the operator overview doc, and the Preview callout.
• Markdown formatting doesn't match our docs set, as we discussed already.
• Similarly, some style-related notes on capitalization, use of "we" in tutorials, etc.
• Related: Code and output snippets should be presented cleanly and consistently with how we use them in the docs (see my notes).
• In the guidance, some example yaml is missing where it would greatly help clarity. In particular, the instructions in deploy-cockroachdb-with-kubernetes-operator on configuring locality are confusing to me. I think these parts can be tightened up.
• The two migration docs should more clearly emphasize that they aren't for prod deployments.
• Ensure the "informal" product terminology for the new vs. old operator is consistent throughout.

Otherwise, I took the time to make suggested rewrites, but some of the copy feels more conversational than is helpful (especially in kubernetes-operator-performance). This isn't a blocking comment per se, and a conversational tone can be nice with such a complicated topic. But at times (in the performance doc, and with the locality stuff I mentioned above), I think it obfuscates the guidance itself. Let me know if you want to discuss. I also replaced passive with active language where I saw it.