Skip to content

docs(fern): migrate OpenShell docs to Fern#780

Merged
pimlock merged 10 commits intoNVIDIA:mainfrom
lbliii:fern-conversion-demo
Apr 8, 2026
Merged

docs(fern): migrate OpenShell docs to Fern#780
pimlock merged 10 commits intoNVIDIA:mainfrom
lbliii:fern-conversion-demo

Conversation

@lbliii
Copy link
Copy Markdown
Collaborator

@lbliii lbliii commented Apr 7, 2026

Summary

This PR migrates the OpenShell docs to Fern and carries the follow-up cleanup needed to make the migrated site usable and close to the existing docs experience. It focuses on navigation, content structure, code block behavior, and landing-page polish, while leaving CI workflow work out of this PR.

Related Issue

  • Related to OS-40

Changes

  • Update navigation structure, labels, slugs, redirects, and section/page titles for the migrated Fern docs
  • Convert tutorial walkthroughs to Fern Steps and fix malformed Tabs blocks
  • Normalize code fences from console and bash to shell, and remove copied shell prompt prefixes so pasted commands run cleanly
  • Improve the landing page with tighter badge spacing, a fixed inline animated terminal, llms-only / llms-ignore fallback content, and a global alpha announcement banner
  • Clean up Fern page content and titles across tutorials, sandboxes, inference, security, and reference pages to better match the intended docs experience after migration
  • Revert source docs/ migration edits so this PR stays Fern-only
  • Exclude GitHub workflow / CI preview changes from this PR; those are kept separate on os-40-doc-publishing

Testing

  • mise run pre-commit passes
  • Unit tests added/updated
  • E2E tests added/updated (if applicable)
  • fern check
  • Manual review in local Fern preview for navigation, tutorial steps, tabs, landing page, and banner styling

Checklist

  • Follows Conventional Commits
  • Commits are signed off (DCO)
  • Architecture docs updated (if applicable)

lbliii added 2 commits April 7, 2026 14:14
Signed-off-by: Lawrence Lane <llane@nvidia.com>
Signed-off-by: Lawrence Lane <llane@nvidia.com>
@lbliii lbliii requested a review from a team as a code owner April 7, 2026 18:24
@github-actions
Copy link
Copy Markdown

github-actions bot commented Apr 7, 2026

All contributors have signed the DCO ✍️ ✅
Posted by the DCO Assistant Lite bot.

Signed-off-by: Lawrence Lane <llane@nvidia.com>
@lbliii
Copy link
Copy Markdown
Collaborator Author

lbliii commented Apr 7, 2026

I have read the DCO document and I hereby sign the DCO.

@lbliii

This comment was marked as resolved.

@lbliii

This comment was marked as resolved.

@pimlock pimlock changed the title Fern conversion demo docs(fern): migrate OpenShell docs to Fern Apr 8, 2026
@pimlock
Copy link
Copy Markdown
Collaborator

pimlock commented Apr 8, 2026

Preview https://nvidia-preview-pr-780.docs.buildwithfern.com/openshell/

Note: I will include CI config in a subsequent PR, this one is from an external fork, so things work slightly differently.

pimlock
pimlock previously approved these changes Apr 8, 2026
@pimlock pimlock merged commit f0b5fb9 into NVIDIA:main Apr 8, 2026
9 checks passed
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.

3 participants