Skip to content

IA skeleton part 1: nav structure and task-oriented sections#4836

Merged
shannonbradshaw merged 1 commit intoviamrobotics:new-docs-sitefrom
shannonbradshaw:IA-skeleton-part1
Mar 18, 2026
Merged

IA skeleton part 1: nav structure and task-oriented sections#4836
shannonbradshaw merged 1 commit intoviamrobotics:new-docs-sitefrom
shannonbradshaw:IA-skeleton-part1

Conversation

@shannonbradshaw
Copy link
Collaborator

Summary

  • Establishes the new information architecture nav structure
  • New sidebar styling: collapsed by default, uppercase top-level labels, border separators, no second-nav bar
  • Frontmatter-only stubs for all task-oriented sections: what-is-viam, try, foundation, hardware, data, train, vision, build-modules, motion-planning, navigation, fleet, monitor, organization
  • Old sections (operate, manage, data-ai) hidden from nav via toc_hide but still accessible by URL
  • Config: ul_show=1 for collapsed sidebar

Part 1 of 2 skeleton PRs. Part 2 adds reference section stubs.

Test plan

  • make build-prod passes cleanly
  • All new sections appear in sidebar with correct names and hierarchy
  • Old sections hidden from sidebar but accessible by direct URL
  • Dev tools still visible in sidebar

🤖 Generated with Claude Code

Establish the new information architecture with all task-oriented
sections as frontmatter-only stubs. Reference section stubs follow
in part 2.

Changes:
- config.toml: ul_show=1 (collapsed sidebar)
- SCSS: remove second-nav, add nav-top-section styling, tighter spacing
- sidebar-tree.html: add nav-top-section class, remove overview spans
- navbar.html: remove second-nav bar
- Hide old sections (operate, manage, data-ai) from nav via toc_hide
- New stub sections: what-is-viam, try, foundation, hardware, data,
  train, vision, build-modules, motion-planning, navigation, fleet,
  monitor, organization

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
@netlify
Copy link

netlify bot commented Mar 18, 2026

Deploy Preview for viam-docs ready!

Name Link
🔨 Latest commit 5549945
🔍 Latest deploy log https://app.netlify.com/projects/viam-docs/deploys/69bab7510bc106000889176f
😎 Deploy Preview https://deploy-preview-4836--viam-docs.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.
Lighthouse
Lighthouse
1 paths audited
Performance: 39 (🔴 down 3 from production)
Accessibility: 100 (no change from production)
Best Practices: 100 (no change from production)
SEO: 92 (no change from production)
PWA: 70 (no change from production)
View the detailed breakdown and full score reports

To edit notification comments on pull requests, go to your Netlify project configuration.

@shannonbradshaw shannonbradshaw merged commit 2fe596b into viamrobotics:new-docs-site Mar 18, 2026
11 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.

1 participant