Skip to content

Replace operate/ skipPatterns with real URL redirects#4986

Merged
shannonbradshaw merged 1 commit intoviamrobotics:mainfrom
shannonbradshaw:operate-url-redirects
Apr 20, 2026
Merged

Replace operate/ skipPatterns with real URL redirects#4986
shannonbradshaw merged 1 commit intoviamrobotics:mainfrom
shannonbradshaw:operate-url-redirects

Conversation

@shannonbradshaw
Copy link
Copy Markdown
Collaborator

Summary

Production deploy is failing because the operate-removal PR (#4983) used `skipPatterns` to silence the no-more-404 plugin instead of writing real redirects. Skipping just hides the warning — users with bookmarked URLs still hit 404s.

This PR replaces the skipPatterns with proper `[[redirects]]` rules using destinations from `~/viam/code-map/operate-removal-plan.md`.

What changed

skipPatterns — kept only `/tags/` (Hugo auto-generates these from frontmatter and they legitimately come and go with content). Removed 17 other entries that masked real 404s.

Added ~50 redirect rules for:

  • `operate/hello-world/` paths → `/try/`, `/what-is-viam/`
  • `operate/mobility/use-input-to-act/` → `/hardware/common-components/add-an-input-controller/`
  • `operate/get-started/other-hardware/hello-world-module/` → `/build-modules/write-a-driver-module/`
  • `operate/modules/` paths (basics, deploy-module, create-module/, other-hardware/, supported-hardware/* for 14 components, orted-hardware/* typo) → `/build-modules/` or `/hardware/common-components/add-{X}/`
  • `operate/reference/{module-configuration,naming-modules,services/frame-system/frame-config}`
  • SLAM URLs → `/navigation/` (per Shannon: SLAM content removed but redirect to navigation section)
  • Old IA paths: `architecture/`, `internals/`, `components/camera/calibrate/`, `components/movement-sensor/set-up-base-station/`
  • Old micro-rdk paths: `build/micro-rdk/X`, `micro-rdk/X` for 8 component types → `/reference/components/X/micro-rdk/`
  • Long-deleted tutorials → `/tutorials/` or specific component pages

Test plan

  • Deploy preview succeeds (no "paths missing" error)
  • Production deploy on merge succeeds

🤖 Generated with Claude Code

The operate-removal PR's skipPatterns silenced the no-more-404 plugin
without actually redirecting the URLs — users with bookmarked links
would still hit 404s. Replace with proper [[redirects]] rules per
~/viam/code-map/operate-removal-plan.md.

- Remove 17 paths from skipPatterns (keep only /tags/, which is Hugo
  auto-generated and legitimately unredirectable)
- Add ~50 specific [[redirects]] entries:
  - operate/hello-world/, operate/mobility/, operate/get-started/ paths
  - operate/modules/ (basics, deploy-module, advanced/module-naming,
    create-module/*, other-hardware/*, supported-hardware/X for 14
    components, orted-hardware/* typo paths)
  - operate/reference/{module-configuration,naming-modules,
    services/frame-system/frame-config}
  - SLAM URLs (services/slam/, mobility/slam/, operate/reference/services/slam/)
    redirect to /navigation/
  - Old IA paths (architecture/, internals/, components/camera/calibrate/,
    components/movement-sensor/set-up-base-station/)
  - Old micro-rdk paths (build/micro-rdk/X, micro-rdk/X for 8 component types)
  - Long-deleted tutorials (build-a-mock-robot, configure-a-camera, etc.)

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 1e4f326
🔍 Latest deploy log https://app.netlify.com/projects/viam-docs/deploys/69e6938bcbd4730008efee24
😎 Deploy Preview https://deploy-preview-4986--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: 45 (🟢 up 6 from production)
Accessibility: 99 (no change from production)
Best Practices: 92 (no change 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 shannonbradshaw merged commit d73771d into viamrobotics:main Apr 20, 2026
13 checks passed
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