Skip to content

Remove operate/ section; add 97 aliases to new-IA pages#4983

Merged
shannonbradshaw merged 8 commits intoviamrobotics:mainfrom
shannonbradshaw:operate-removal
Apr 20, 2026
Merged

Remove operate/ section; add 97 aliases to new-IA pages#4983
shannonbradshaw merged 8 commits intoviamrobotics:mainfrom
shannonbradshaw:operate-removal

Conversation

@shannonbradshaw
Copy link
Copy Markdown
Collaborator

Summary

Removes the entire operate/ directory (162 non-draft pages, excluding SLAM). Adds 97 aliases across 67 destination pages so every /operate/* URL redirects to its new-IA equivalent.

Changes

  • Deletes docs/operate/ — hello-world, install, modules, control, and reference subsections
  • 97 aliases added across 67 destination pages (full mapping in code-map/operate-removal-plan.md)
  • Card link fixes in layouts/404.html and static/include/components/camera-model-next-steps.md
  • 4 pre-existing stale UI labels fixed

Follow-up work (not in this PR)

Test plan

  • make build-prod clean (941 pages, 972 aliases)
  • Pre-commit hooks pass
  • Netlify no-more-404 plugin
  • python3 code-map/scripts/test-app-urls.py --base-url <preview>

🤖 Generated with Claude Code

@netlify
Copy link
Copy Markdown

netlify Bot commented Apr 20, 2026

Deploy Preview for viam-docs ready!

Name Link
🔨 Latest commit 1c49f3c
🔍 Latest deploy log https://app.netlify.com/projects/viam-docs/deploys/69e68af58fd717000844d4f7
😎 Deploy Preview https://deploy-preview-4983--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: 41 (🟢 up 2 from production)
Accessibility: 99 (no change from production)
Best Practices: 83 (🔴 down 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 4 commits April 20, 2026 15:07
Delete the entire operate/ directory (162 non-draft pages, excluding
SLAM which was already migrated). Add 97 aliases across 67 destination
pages so every operate/ URL resolves to its new-IA equivalent.

Also fixes:
- 404.html card links (operate/install/setup → set-up-a-machine/overview)
- camera-model-next-steps.md include (operate/ camera links → new paths)
- 4 pre-existing stale UI labels (Component or service → Configuration
  block; Click Test → Expand TEST section)

446 body-text references to /operate/ remain across tutorials and other
pages. These redirect through aliases and are a follow-up cleanup task.

Full mapping documented in code-map/operate-removal-plan.md.
13 pages on the revisit list where the alias is accepted but unique
content needs a proper new-IA home.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
…i, advanced-patterns

- Migrate controls-package as reference/controls-package.md, updated to
  current RDK source (PIDSets attribute, TunedVals field, added Derivative
  and Filter block sections, fixed function name typo)
- Add camera calibration section to add-a-camera page, move calibrate alias
  to camera-calibration.md
- Merge wifi-credentials content into rpi-setup, remove YouTube embed
- Create build-modules/advanced-patterns.md combining content from 4 old
  operate/reference/advanced-modules pages
- Add module-configuration anchor to module-reference.md
- Fix motion service links and minor cleanups across multiple pages

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Add blank line before list after "Keep in mind:" paragraph.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
SLAM content is being removed entirely. Delete the glossary file and
replace tooltip references with plain text on the 2 pages that link
to it.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
shannonbradshaw and others added 4 commits April 20, 2026 15:33
The motion service docs reference SLAM via glossary tooltips. Since
the SLAM glossary entry is removed, replace tooltips with plain text
in the static include files.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
- Apply operate/ → new-IA mapping to all static/include/ files (81 files)
- Update remaining service body-text links in 7 docs files (operate/reference/services/X/ → /reference/services/X/)
- Strip SLAM service link from motion API includes (slam pages deleted)
- Remove broken Desk Safari tutorial link from try-example include

After this change, all internal htmltest checks pass locally.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
- Remove SLAM service row from data capture-supported include
- Drop #configuration anchor from board API include links
  (new board landing page does not have a configuration section)
- Fix #rotate-an-api-key anchor → #rotate-a-key on api-keys page

Local htmltest now passes with the CI config (.htmltest-local.yml).

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Netlify no-more-404 plugin requires either alias or skipPattern for
130 paths that existed on production before operate/ deletion.

- Add /operate/reference/components/X/Y/ aliases to 43 component model
  pages (so URLs like /operate/reference/components/motor/encoded-motor/
  redirect to the new-IA equivalent)
- Add /operate/reference/components/servo/ alias to servo landing
- Add /operate/reference/services/X/ aliases to 5 service pages from viamrobotics#4978
- Extend skipPatterns in netlify.toml for paths intentionally without
  redirect: SLAM (deleted entirely), Hugo tag pages, old IA paths
  (architecture/, build/micro-rdk/, micro-rdk/, internals/), pre-cutover
  operate/ paths (get-started, hello-world, mobility, modules), and
  long-deleted tutorials

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

viambot commented Apr 20, 2026

It looks like the following files may have been renamed. Please ensure you set all needed aliases:
rename docs/{operate => }/reference/controls-package.md (18%)

@shannonbradshaw shannonbradshaw merged commit 62bbd4d into viamrobotics:main Apr 20, 2026
11 of 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