Migrate SQL docs

[kbatuigas]

Description

This PR adds the converted content (MDX/Mintlify -> AsciiDoc/Antora) from docs.oxla.com into our Cloud docs.

The bulk of this migration involves SQL reference pages, which have been added to a new sql subdirectory in the existing reference module.

A few pages have also been added to a new sql module. These pages are organized under the "Redpanda SQL" section in the navigation.

Items for manual review

(Not completed in the first pass at QA as described in Fixes done below)

Oxla references

• Names and identifiers - Oxla/Cloud SMEs to help in this area
  • 'Oxla' / 'OxlaDocumentation' in code block string literals
  • oxla.enable_fast_math (set-show.adoc)
    • Actual config property name — confirm whether this is renamed
  • hello@oxla.com
  • oxladb and oxlarefs as example schema names
    • replace with neutral name or placeholder
  • Docker image URL and connection params: public.ecr.aws/oxla/release:latest and Oxla-specific connection strings
  • oxla_internal.oxla_role and n_oxla_node_* (system catalog pages)

Page attributes

• Description - most of these are derived from the first few lines of the page content. May require rewrite.
• Learning objectives

Style fixes (context-dependent)

• Deprecated terms (~42 occurrences in ~27 files)

  • e.g. → "for example" (rewrite surrounding sentence for flow)
  • i.e. → "that is" (or rewrite to avoid the parenthetical)
  • please → remove or rewrite
  • etc. → specific list or remove

• Passive voice (~93 occurrences across ~43 files)

  • Common patterns: "is used", "are used", "is supported", "is returned", "is specified"
  • Rewrite to active voice or restructure sentence

• First person (~354 occurrences in ~130 files)

  • "we", "our", "let's" → second person ("you") or imperative

• Directional language (~739 occurrences in ~176 files)

  • "below", "above", "following" — remove or restructure

Links

• Check each link text renders correctly

Fixes done

Branding / Oxla references

• Replaced prose occurrences of "Oxla" with "Redpanda SQL" across reference/sql pages (outside code blocks)
• Removed "Oxla" from :description: attributes, table headers, xref link text, NOTE blocks

Metadata

• Added :page-topic-type: concept to 3 sql module get-started pages
• Added :page-topic-type: reference to all non-index pages in reference/pages/sql/ (172 pages)
• Trimmed 3 :description: attributes exceeding 155 characters

Headings — prohibited patterns

• Removed Case #N:, #Case N:, Case N:, Step #N:, Step N., A), B) prefixes from section headings (~75 headings
  across 31+ files)
• Stripped numeric prefixes

Headings — title case → sentence case

• Converted ~142 title-case H2+ headings to sentence case (65 files)

Headings — gerunds → imperative/noun phrase

• Converted ~80 gerund headings (Creating, Handling, Truncating, etc.) to imperative or noun phrase form (30
  files)

Links — external links open in new window using ^

Style

• Em dashes → comma/parentheses (3 get-started pages)
• & → and in headings
• Replaced list item workaround using arabic notation with proper AsciiDoc list continuation with + (31 files)

Resolves https://github.com/redpanda-data/documentation-private/issues/
Review deadline:

Page previews

Reference > Redpanda SQL Reference
Redpanda SQL (guides, concepts, etc) - where most new content will be added

Checks

• New feature
• Content gap
• Support Follow-up
• Small fix (typos, links, copyedits, etc)

[coderabbitai]

Important

Review skipped

Auto reviews are disabled on base/target branches other than the default branch.

Please check the settings in the CodeRabbit UI or the .coderabbit.yaml file in this repository. To trigger a single review, invoke the @coderabbitai review command.

⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro

Run ID: 5d968172-5cf1-466c-9cf5-ab755e5c4511

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

Use the checkbox below for a quick retry:

• 🔍 Trigger review

✨ Finishing Touches

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Post copyable unit tests in a comment
• Commit unit tests in branch DOC-1984-convert-and-migrate-existing-oxla-docs-to-asciidoc

---

_{Comment @coderabbitai help to get the list of available commands and usage tips.}

[netlify]

✅ Deploy Preview for rp-cloud ready!

Name	Link
🔨 Latest commit	a95a3ed
🔍 Latest deploy log	https://app.netlify.com/projects/rp-cloud/deploys/69b224688107470008854d7e
😎 Deploy Preview	https://deploy-preview-521--rp-cloud.netlify.app
📱 Preview on mobile	Toggle QR Code... Use your smartphone camera to open QR code link.

---

To edit notification comments on pull requests, go to your Netlify project configuration.