Skip to content

docs: consolidate documentation structure#1231

Merged
drew merged 7 commits into
mainfrom
update-docs
May 7, 2026
Merged

docs: consolidate documentation structure#1231
drew merged 7 commits into
mainfrom
update-docs

Conversation

@drew
Copy link
Copy Markdown
Collaborator

@drew drew commented May 7, 2026

Summary

Consolidates the docs navigation and merges overlapping overview pages into fewer, clearer documentation surfaces.

Related Issue

None.

Changes

  • Merge gateway and sandbox overview content into the main Sandboxes and Gateways pages.
  • Move Inference Routing under How It Works and collapse the separate inference pages into a single page.
  • Move Architecture into a dedicated How OpenShell Works page under About, with a shorter Mermaid-based architecture section.
  • Document local machine and remote Kubernetes deployment models on the How OpenShell Works page.
  • Document supervisor protection layers for process, filesystem, network, credentials, inference, and observability boundaries.
  • Update Gateway Authentication with OIDC support and generic mTLS environment-variable setup.
  • Rename Get OpenShell to Installation and update internal links.
  • Remove standalone About Gateways and Sandboxes, Community Sandboxes, Architecture, and inference section pages.
  • Update navigation, homepage cards, and cross-links to the new page locations.

Testing

  • mise run docs:build:strict passes
  • mise run markdown:lint passes
  • mise run pre-commit passes
  • Unit tests added/updated
  • E2E tests added/updated (if applicable)

Checklist

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

Signed-off-by: Drew Newberry <anewberry@nvidia.com>
@drew drew requested review from a team, derekwaynecarr, maxamillion and mrunalp as code owners May 7, 2026 06:37
drew added 2 commits May 6, 2026 23:47
Signed-off-by: Drew Newberry <anewberry@nvidia.com>
Signed-off-by: Drew Newberry <anewberry@nvidia.com>
@github-actions
Copy link
Copy Markdown

github-actions Bot commented May 7, 2026

drew added 2 commits May 7, 2026 00:02
Signed-off-by: Drew Newberry <anewberry@nvidia.com>
Signed-off-by: Drew Newberry <anewberry@nvidia.com>
@drew drew requested a review from miyoungc May 7, 2026 07:36
TaylorMutch
TaylorMutch previously approved these changes May 7, 2026
Comment thread docs/reference/support-matrix.mdx Outdated
@drew drew self-assigned this May 7, 2026
@drew drew merged commit 728165a into main May 7, 2026
24 checks passed
@drew drew deleted the update-docs branch May 7, 2026 16:14
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.

2 participants