Skip to content

Update Cloud docs landing page to component-home-v3#578

Open
JakeSCahill wants to merge 22 commits into
mainfrom
feature/component-home-v3
Open

Update Cloud docs landing page to component-home-v3#578
JakeSCahill wants to merge 22 commits into
mainfrom
feature/component-home-v3

Conversation

@JakeSCahill
Copy link
Copy Markdown
Contributor

Summary

Migrates the Cloud docs landing page to use the new component-home-v3 layout with configurable content via page attributes.

Page Attributes Added

Deploy Section

Attribute Description
:page-deploy-title: Section heading
:page-deploy-N-title: Card title (N = 1-3)
:page-deploy-N-desc: Card description
:page-deploy-N-link: Card link (Antora resource ID)
:page-deploy-N-icon: Card icon name

Popular Topics Section

Attribute Description
:page-popular-title: Section heading
:page-popular-N-title: Card title (N = 1-4)
:page-popular-N-desc: Card description
:page-popular-N-link: Card link (Antora resource ID)
:page-popular-N-icon: Card icon name

Labs Section

Attribute Description
:page-labs-title: Section heading
:page-labs-link: Link to all labs
:page-labs-N-title: Lab title (N = 1-4)
:page-labs-N-link: Lab link (external URL)

Stats Bar

Attribute Description
:page-stats: Pipe-separated stats with ;; delimiter

Related

Migrates Cloud docs landing page to use the new component-home-v3 layout
with configurable content via page attributes.

## Deploy Section
- :page-deploy-title: Section heading
- :page-deploy-N-title/desc/link/icon: Card content (up to 3)

## Popular Topics Section
- :page-popular-title: Section heading
- :page-popular-N-title/desc/link/icon: Card content (up to 4)

## Labs Section
- :page-labs-title: Section heading
- :page-labs-link: Link to all labs
- :page-labs-N-title/link: Individual lab links

## Stats Bar
- :page-stats: Pipe-separated stats with ;; delimiter

Related: redpanda-data/docs-ui#376
@JakeSCahill JakeSCahill requested a review from a team as a code owner May 8, 2026 07:42
@netlify
Copy link
Copy Markdown

netlify Bot commented May 8, 2026

Deploy Preview for rp-cloud ready!

Name Link
🔨 Latest commit 96ccb55
🔍 Latest deploy log https://app.netlify.com/projects/rp-cloud/deploys/6a0dc60c23fd73000899c2b1
😎 Deploy Preview https://deploy-preview-578--rp-cloud.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.

@coderabbitai
Copy link
Copy Markdown
Contributor

coderabbitai Bot commented May 8, 2026

Review Change Stack

Important

Review skipped

Auto incremental reviews are disabled on this repository.

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: fd7f5291-9e7b-427b-8709-92082d041f62

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
📝 Walkthrough

Walkthrough

The home page for Redpanda Cloud documentation is migrated from component-home-v2 to component-home-v3, with a refreshed page description. All major sections are updated: the deploy section now features Serverless, Dedicated cluster, and Bring Your Own Cloud with new descriptions and icons; the Popular topics section is revised with Billing, Security, Networking, and rpk commands entries; a new Labs for Redpanda Cloud section is added with four lab entries linked to external GitHub repositories; and the stats bar messaging is rewritten to highlight Serverless deployment speed, pay-as-you-go pricing, zero infrastructure setup, and automatic scaling.

Estimated code review effort

🎯 2 (Simple) | ⏱️ ~10 minutes

Suggested reviewers

  • WillemKauf
  • dotnwat
  • Feediver1
🚥 Pre-merge checks | ✅ 4 | ❌ 1

❌ Failed checks (1 warning)

Check name Status Explanation Resolution
Description check ⚠️ Warning The description is well-structured with detailed documentation of page attributes added, but it does not follow the repository's required template structure with issue resolution link, page previews, or category checkboxes. Add the required template sections: issue link (Resolves #...), page preview link, review deadline, and category checkboxes (New feature/Content gap/Support Follow-up/Small fix).
✅ Passed checks (4 passed)
Check name Status Explanation
Title check ✅ Passed The title accurately and concisely describes the main change: migrating the Cloud docs landing page to use the new component-home-v3 layout.
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Linked Issues check ✅ Passed Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check ✅ Passed Check skipped because no linked issues were found for this pull request.

✏️ Tip: You can configure your own custom pre-merge checks in the settings.

✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch feature/component-home-v3

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

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

@JakeSCahill
Copy link
Copy Markdown
Contributor Author

JakeSCahill commented May 12, 2026

Jira: DOC-2180

JakeSCahill and others added 21 commits May 12, 2026 12:15
- Updated xrefs and includes: ROOT → streaming
- Updated xrefs: redpanda-connect → connect

This allows cloud-docs to correctly include single-sourced content
from the renamed streaming component.
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
…ption

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
- product-name: Redpanda Streaming (for self-managed references)
- cloud-product-name: Redpanda Cloud (for cloud references)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
- More accurate name: component-level metadata, not page-level
- Remove section field (deprecated - breadcrumbs use page-navigation config)
- Update Cloud component configuration

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
- Hero: Add "Streaming, Connect, and SQL built in" to clarify offerings
- Remove "Get started with Redpanda Cloud" deploy section per PM feedback
- Update labs links to use Antora resource IDs (labs:ai-agents:langchain-agent.adoc, etc.)
- All labs are Cloud-compatible (have page-cloud: true attribute)
- Decision matrix remains for Serverless vs BYOC choice

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
Change xref:home:streaming:mcp-setup.adoc to xref:home:ROOT:mcp-setup.adoc

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
* Add converted SQL reference files

* Duplicate file

* Add index files

* Add SQL reference to Cloud nav

* Move reference pages to reference module

* Convert remaining docs

* Add placeholder index files

* Cleanup

* Move SQL section after RPCN

* Continue cleanup using plugin audit and review

* External links open in new window

* Minor edit to trigger deploy preview

* Migrate degraded state doc

* Minor style edits

* Address drift from Oxla changes since mid-Oct 2025

* Include CREATE TABLE and DROP changes

* Update existing pages with placeholders for pages to be created

* Another pass at style fixes

* Missing TODO

* Add remaining new reference pages to address doc drift

* Remove Oxla storage compression references

* Remove INSERT/UPDATE/DELETE from psycopg2 supported features

* Remove Oxla-specific reasons from java-jdbc unsupported list

* Remove DELETE/UPDATE references from php-pdo rowCount

* Remove CREATE TABLE/INSERT example from select.adoc

Assume that a student_data table is already created and populated with data

* Remove table duplication TIP

* Fix clumped "SELECTstatement"

* Add missing Venn diagrams to JOIN pages

* Inconsistent formatting with function names and parentheses

* Incorrect COUNT logic with HAVING

* Add NULLS FIRST/LAST, fix interval sorting

* Replace CREATE TABLE oxlafunctions example in offset.adoc

Redpanda SQL does not support CREATE TABLE without an external catalog

Example assumes precreated salaryemp table

* Unrelated "employees" text

* Move column compatibility note to set-operations index

Column type compatibility and flexible ordering
applies to all set operations (UNION, INTERSECT, EXCEPT)

* Both ROWS and RANGE frame modes are supported

* Add GEOMETRY/GEOGRAPHY

* Create sql-operators section with full operator list

* timestamp-with-time-zone formatting

* Remove internal memory representation for date type

* Add month and day conversion note

* Remove internal memory representation from bool type

* System catalogs disambiguation note and 7 new pg_* pages

* Fix nav

* Move bitwise operators

* Double check SQL examples and outputs

* Remove unix_macros

* Reorganize math and trig function pages

* Implement some deferred fixes related to old Oxla examples

* Fix anchors in xrefs

* Apply QA checklist first pass across SQL reference docs

Run 11-point QA checklist against all migrated SQL pages (148 files).
Fixes applied: remove "Please note" phrasing, fix "here" link text,
replace future tense output descriptions with present tense, simplify
"allows/enables you to" constructions, remove minimizing language,
fix wordy instructions, add missing admonition punctuation, replace
verbose output lead-ins, remove "etc.", normalize positional references,
and update stale PostgreSQL doc links to /docs/current/.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

* Person 4 edits, including future tense, passive voice

* more Person 4 edits

* Person 4 edits

* Parallelize :description: metadata for SQL language client pages

Standardize the Java, PHP, and Python connector pages on the same
imperative "Connect to Redpanda SQL from <language> using <tool>"
template already used by the C# page and the parent index page.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

* Apply Feediver1 review suggestions

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

* Apply pending PR suggestion comments

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

* Minor edit - statements index

* keywords.adoc - move in nav tree, make table more scannable

* alter-table minor edit

* create-redpanda-catalog: Improve Options section

* create-storage minor edit

* Improve CREATE TABLE reference page clarity

Clarify NOTE about CREATE TABLE behavior, convert multi-value option
descriptions to lists for scannability, and rename ambiguous example
heading.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

* select: review fixes

* set-show: review fixes

* show-tables minor edit

* show-nodes: review fixes

* describe: review fixes

* sql-statements review pass

* from - review pass

* Minor edit

* set-operations: review fixes

* More review fixes for sql-clauses

* other-functions review fixes

* Normalize QA fixes

* Apply edits based on doc team review

* Standardize "To do X, run:"

* Structural improvements

* Sweep for passive voice

* Person 2 style review: aggregate, window, JSON functions

Style fixes across 31 files:
- Future tense → present tense ("will return" → "returns")
- Wordy instructions ("lets you" → direct verb)
- Awkward phrasing ("Here's how" → cleaner alternatives)
- First person ("we're going to" → "This example")
- Passive "It" patterns in tables → active voice
- Positional references ("the above query" → "Output:")
- Typo fix ("ouput" → "output")

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

* Pass to standardize QA

* Apply suggestions from review

* Minor edits

---------

Co-authored-by: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Co-authored-by: micheleRP <michele@redpanda.com>
Co-authored-by: Joyce Fee <joyce@redpanda.com>
Co-authored-by: JakeSCahill <jake@redpanda.com>
* SQL GA nav

* DOC-1993: Move Redpanda Catalogs page to sql module under Query data

Relocates redpanda-catalogs.adoc from modules/reference/pages/sql/ to
modules/sql/pages/query-data/, adds the entry under SQL > Query data in
nav.adoc, removes the old entry from Reference > Redpanda SQL Reference,
and updates the cross-link in system-catalogs/index.adoc. Structural-only;
no content changes (content rewrite is in DOC-2049).

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

---------

Co-authored-by: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
- Duplicate component-whats-new attributes as page-whats-new
- page-whats-new displays on cloud home page
- component-whats-new displays on data-platform aggregation page
- Both point to same SQL content
Only page-layout is needed; page-role is redundant as the layout
automatically sets the correct role class.
Defines 4 cloud-specific AI suggestion questions that appear in the Ask AI chat drawer when viewing Cloud documentation.

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
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