Skip to content

Publish analyses in Docus, fix links, rewrite cross-plugin links#351

Open
chalin wants to merge 1 commit intocncf:mainfrom
chalin:chalin-m24-publish-analyses-2026-0416
Open

Publish analyses in Docus, fix links, rewrite cross-plugin links#351
chalin wants to merge 1 commit intocncf:mainfrom
chalin:chalin-m24-publish-analyses-2026-0416

Conversation

@chalin
Copy link
Copy Markdown
Collaborator

@chalin chalin commented Apr 17, 2026

  • Adds analyses/ as a first-class Docusaurus docs instance with its own autogenerated sidebar and navbar entry.
  • This will allow us to preview analyses pages form submitted PRs
  • Fixes broken or placeholder links in affected analysis pages, including companion-document fallbacks and invalid external references.
  • Addresses markdownlint issues in analyses pages
  • And more ... - Rewrites cross-plugin Markdown links so GitHub-authored `docs/` and `analyses/` links resolve correctly on the site. - Rewrites unbundled data asset links such as `.csv` files to GitHub blob URLs so they remain usable in rendered pages. - Restricts preview-only asset URL generation to deploy-preview contexts while keeping local builds pinned to the canonical `main` branch URLs. - Moves build-context and GitHub/branch detection logic into small helpers under `lib/`. - Normalizes imported root `README.md` links for the preview site without changing general content-plugin behavior. - Adds unit tests for link-rewrite behavior, including `.mdx` handling, passthrough cases, and full remark-pipeline coverage. - Updates markdown and link-check tooling configuration to match the new analyses publishing flow. - Replaces empty-hash KEDA deployment links with verified upstream section anchors. - Updates Helm and Knative analysis content to avoid dead or misleading external links. - Keeps TypeScript validation working with the current Docusaurus/TypeScript configuration.

Preview: https://deploy-preview-351--cncf-techdocs.netlify.app/

Screenshot

image

Signed-off-by: Patrice Chalin <pchalin@gmail.com>
@chalin chalin added the enhancement New feature or request label Apr 17, 2026
@netlify
Copy link
Copy Markdown

netlify bot commented Apr 17, 2026

Deploy Preview for cncf-techdocs ready!

Name Link
🔨 Latest commit 6371b6f
🔍 Latest deploy log https://app.netlify.com/projects/cncf-techdocs/deploys/69e1a33cd74acc0008a96297
😎 Deploy Preview https://deploy-preview-351--cncf-techdocs.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.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

enhancement New feature or request

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants