Skip to content

Docs: Add unified catalog overview page#15942

Open
kellykohlleffel wants to merge 1 commit intoapache:mainfrom
kellykohlleffel:docs-catalog-overview
Open

Docs: Add unified catalog overview page#15942
kellykohlleffel wants to merge 1 commit intoapache:mainfrom
kellykohlleffel:docs-catalog-overview

Conversation

@kellykohlleffel
Copy link
Copy Markdown

Summary

  • Adds a new catalogs.md page that defines what a catalog is in the Iceberg
    context, describes all built-in and third-party catalog types, provides a
    decision matrix for choosing a catalog, and includes configuration examples
  • Adds the page to both nav.yml and mkdocs-dev.yml as a top-level
    "Catalogs" navigation entry

Partially addresses #7785

Changes

  • New file: site/docs/catalogs.md
  • Updated: site/nav.yml — added Catalogs nav entry
  • Updated: site/mkdocs-dev.yml — matching nav entry for dev builds

AI Disclosure

This documentation was drafted with AI assistance (Claude Code) and fully
reviewed and validated by the author before submission.

Testing

  • make lint passes with no errors
  • make serve-dev renders the page correctly
  • All internal links resolve (verified with curl — all HTTP 200)
  • Navigation sidebar shows the page in the correct location

Add a new top-level Catalogs page that provides a central location
defining what an Iceberg catalog is, lists all supported catalog types
with descriptions, includes a decision matrix for choosing a catalog,
and links to detailed per-catalog documentation.

Partially addresses apache#7785
@github-actions github-actions bot added the docs label Apr 11, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant