Skip to content

Update body-text links from operate/ to new-IA paths#4984

Merged
shannonbradshaw merged 4 commits intoviamrobotics:mainfrom
shannonbradshaw:fix-operate-body-links
Apr 20, 2026
Merged

Update body-text links from operate/ to new-IA paths#4984
shannonbradshaw merged 4 commits intoviamrobotics:mainfrom
shannonbradshaw:fix-operate-body-links

Conversation

@shannonbradshaw
Copy link
Copy Markdown
Collaborator

Summary

Mapping:

  • /operate/reference/components/*/reference/components/*
  • /operate/reference/services/*/reference/services/*
  • /operate/reference/viam-server//reference/viam-server/
  • /operate/modules/write-a-*//build-modules/write-a-*/
  • /operate/modules/configure-modules//hardware/configure-hardware/
  • /operate/install/setup//set-up-a-machine/overview/
  • /operate/control/*/build-apps/overview/ or /organization/access/
  • /operate/hello-world/*/try/
  • /operate/reference/architecture/*/hardware/multi-machine/overview/
  • /operate/reference/services/frame-system//motion-planning/frame-system/overview/

Test plan

🤖 Generated with Claude Code

Replace 283 body-text markdown links across 128 files that reference
/operate/ paths with their new information architecture equivalents.
This prepares for the operate/ section removal by ensuring all
cross-references already point to the correct destinations.

Mapping summary:
- /operate/reference/components/* → /reference/components/*
- /operate/reference/services/* → /reference/services/*
- /operate/reference/viam-server/ → /reference/viam-server/
- /operate/modules/write-a-*/ → /build-modules/write-a-*/
- /operate/modules/configure-modules/ → /hardware/configure-hardware/
- /operate/install/setup/ → /set-up-a-machine/overview/
- /operate/control/* → /build-apps/overview/ or /organization/access/
- /operate/hello-world/* → /try/
- /operate/reference/architecture/* → /hardware/multi-machine/overview/
- /operate/reference/services/frame-system/ → /motion-planning/frame-system/overview/

Also fixes 10 pre-existing "Component or service" UI label violations
(should be "Configuration block") in touched files.

Does not modify files within docs/operate/ (those are deleted separately).

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

netlify Bot commented Apr 20, 2026

Deploy Preview for viam-docs ready!

Name Link
🔨 Latest commit b4ca103
🔍 Latest deploy log https://app.netlify.com/projects/viam-docs/deploys/69e66757d86c7000088a8659
😎 Deploy Preview https://deploy-preview-4984--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: 46 (🟢 up 6 from production)
Accessibility: 99 (no change from production)
Best Practices: 92 (🟢 up 9 from production)
SEO: 89 (no change from production)
PWA: 60 (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.

@viambot viambot added the safe to build This pull request is marked safe to build from a trusted zone label Apr 20, 2026
shannonbradshaw and others added 3 commits April 20, 2026 13:36
Keep base-rc, discovery, generic, navigation, and slam service links
pointing to /operate/reference/services/ since those pages haven't
been migrated to /reference/services/ on main yet. Also fix prettier
formatting on monitor/overview.md.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
- /organization/access/#add-an-api-key → /organization/api-keys/#create-an-api-key
- Drop #configuration and #api anchors on component landing pages
  (new pages don't have those sections)
- Fix #configure-a-sub-part → link to add-a-sub-part page
- Drop #prerequisite-install-operating-system anchor

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
The no-more-404 plugin detected 4 micro-RDK pages that existed at
operate/reference/components/ paths on production but were missing
aliases on the new reference/components/micro-rdk/ pages.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
@shannonbradshaw shannonbradshaw merged commit 55f4ef7 into viamrobotics:main Apr 20, 2026
12 checks passed
@github-actions
Copy link
Copy Markdown

🔎💬 Inkeep AI search and chat service is syncing content for source 'Viam Docs'

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

Labels

safe to build This pull request is marked safe to build from a trusted zone

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants