Skip to content

docs: Point CRD reference links at the Stackable Hub#868

Open
lfrancke wants to merge 4 commits into
mainfrom
docs/crd-links-to-hub
Open

docs: Point CRD reference links at the Stackable Hub#868
lfrancke wants to merge 4 commits into
mainfrom
docs/crd-links-to-hub

Conversation

@lfrancke

@lfrancke lfrancke commented Jul 7, 2026

Copy link
Copy Markdown
Member

Description

The old CRD browser at crds.stackable.tech is being discontinued in favor of the CRD reference on the Stackable Hub, which ingests the CRDs of every operator automatically.

This updates all references that do not depend on the CRD detail-page URL structure:

  • netlify.toml: redirect target for /home/stable/reference/* now points at the Hub
  • Contributor guide: docs/crd-documentation.adoc, docs/overview.adoc and project-overview.adoc no longer describe the crddocs generation pipeline; they point at the Hub and note that ingestion is automatic
  • README.adoc: link list entry
  • project-overview-documentation.drawio.svg

The old CRD browser at crds.stackable.tech is being discontinued in
favor of the CRD reference on the Stackable Hub, which ingests the
CRDs of every operator automatically.

- Update the netlify redirect target for /home/stable/reference/*
- Update the contributor guide pages that described the crddocs
  generation pipeline
- Update the README link list

The crd-docs-base-url attribute in antora.yml (used by the operator
link bars and CRD deep links) is intentionally unchanged: it needs the
group/version/kind URL structure on the Hub before it can be switched.
@netlify

netlify Bot commented Jul 7, 2026

Copy link
Copy Markdown

Deploy Preview for stackable-docs ready!

Name Link
🔨 Latest commit c786a62
🔍 Latest deploy log https://app.netlify.com/projects/stackable-docs/deploys/6a4d7ec7ab92590008755c47
😎 Deploy Preview https://deploy-preview-868--stackable-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.

lfrancke added 3 commits July 8, 2026 00:19
Remove the crddocs repository box from page 2 of the embedded draw.io
source in all three project-overview SVGs, relabel crds.stackable.tech
to hub.stackable.tech and connect the operator repositories directly to
it (the Hub ingests the CRDs, Netlify only serves the docs site).

Only project-overview-documentation.drawio.svg renders that page, so
the other two files change only in their embedded source.
Only project-overview-documentation.drawio.svg renders the diagram page
containing the crddocs box; the other two only changed in their embedded
draw.io source, so keep them untouched.
@lfrancke lfrancke moved this to Development: Waiting for Review in Stackable Engineering Jul 7, 2026
@lfrancke lfrancke self-assigned this Jul 7, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

Status: Development: Waiting for Review

Development

Successfully merging this pull request may close these issues.

1 participant