Skip to content

[Proof of Concept] Port RAPIDS docs from Jekyll to Sphinx#807

Draft
bdice wants to merge 17 commits into
rapidsai:mainfrom
bdice:sphinx-port
Draft

[Proof of Concept] Port RAPIDS docs from Jekyll to Sphinx#807
bdice wants to merge 17 commits into
rapidsai:mainfrom
bdice:sphinx-port

Conversation

@bdice

@bdice bdice commented Jul 6, 2026

Copy link
Copy Markdown
Contributor

Summary

  • port the RAPIDS documentation portal from Jekyll to Sphinx, MyST, and the NVIDIA Sphinx theme
  • preserve the published routes, notices, release and platform data, installation selector, visualizations, redirects, RSS feed, and production telemetry
  • adapt the S3 assembly and post-processing pipeline to the locked uv environment and add Netlify previews for copied pull request branches

Validation

  • pre-commit run --all-files
  • pytest (3 tests passed)
  • strict Sphinx dirhtml build with warnings treated as errors (129 sources)
  • rendered-site validation (132 HTML files and 94 notices)
  • route and heading comparison against the Jekyll baseline (128 routes)

The S3-backed full-site assembly and Netlify preview run in the upstream deploy workflow after the copy-PR bot creates the pull-request/<number> branch.

Signed-off-by: Bradley Dice <bdice@bradleydice.com>
Signed-off-by: Bradley Dice <bdice@bradleydice.com>
@bdice bdice changed the title Port RAPIDS docs from Jekyll to Sphinx [Proof of Concept] Port RAPIDS docs from Jekyll to Sphinx Jul 6, 2026
Signed-off-by: Bradley Dice <bdice@bradleydice.com>
@netlify

netlify Bot commented Jul 6, 2026

Copy link
Copy Markdown

Deploy Preview for docs-rapids-ai ready!

Built without sensitive environment variables

Name Link
🔨 Latest commit c1e649e
🔍 Latest deploy log https://app.netlify.com/projects/docs-rapids-ai/deploys/6a4c5fecb9a6f900087838bf
😎 Deploy Preview https://deploy-preview-807--docs-rapids-ai.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.

Signed-off-by: Bradley Dice <bdice@bradleydice.com>
bdice added 3 commits July 6, 2026 20:25
Signed-off-by: Bradley Dice <bdice@bradleydice.com>
Signed-off-by: Bradley Dice <bdice@bradleydice.com>
Restore development support and minimize migration diff
@copy-pr-bot

copy-pr-bot Bot commented Jul 7, 2026

Copy link
Copy Markdown

This pull request requires additional validation before any workflows can run on NVIDIA's runners.

Pull request vetters can view their responsibilities here.

Contributors can view more details about this message here.

Signed-off-by: Bradley Dice <bdice@bradleydice.com>
@bdice

bdice commented Jul 7, 2026

Copy link
Copy Markdown
Contributor Author

/ok to test 0531a34

bdice added 2 commits July 7, 2026 01:44
Signed-off-by: Bradley Dice <bdice@bradleydice.com>
Signed-off-by: Bradley Dice <bdice@bradleydice.com>
@bdice

bdice commented Jul 7, 2026

Copy link
Copy Markdown
Contributor Author

/ok to test ad33396

Signed-off-by: Bradley Dice <bdice@bradleydice.com>
@bdice

bdice commented Jul 7, 2026

Copy link
Copy Markdown
Contributor Author

/ok to test 61cb205

bdice added 2 commits July 7, 2026 01:48
Signed-off-by: Bradley Dice <bdice@bradleydice.com>
Signed-off-by: Bradley Dice <bdice@bradleydice.com>
@bdice

bdice commented Jul 7, 2026

Copy link
Copy Markdown
Contributor Author

/ok to test 32fa1c9

bdice added 3 commits July 7, 2026 01:53
Signed-off-by: Bradley Dice <bdice@bradleydice.com>
Keep portal content at repository root
Signed-off-by: Bradley Dice <bdice@bradleydice.com>
@bdice

bdice commented Jul 7, 2026

Copy link
Copy Markdown
Contributor Author

/ok to test 6166ae2

Signed-off-by: Bradley Dice <bdice@bradleydice.com>
@bdice

bdice commented Jul 7, 2026

Copy link
Copy Markdown
Contributor Author

/ok to test c1e649e

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

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant