Skip to content

Update machine settings card labels for new layout#4898

Merged
shannonbradshaw merged 4 commits intonew-docs-sitefrom
claude/update-machine-settings-redesign
Apr 13, 2026
Merged

Update machine settings card labels for new layout#4898
shannonbradshaw merged 4 commits intonew-docs-sitefrom
claude/update-machine-settings-redesign

Conversation

@shannonbradshaw
Copy link
Copy Markdown
Collaborator

Source changes

  • viamrobotics/app#11640 (APP-15678): The Machine Settings card was redesigned. The flat CardLayout was replaced with a nested CardSection hierarchy. Settings are now collapsible subsections under a top-level Settings section, plus a separate Details section.
    • "Viam agent version control" → "Software Updates"
    • "Agent advanced settings" → "Advanced"
    • "Networks" → "Known Networks"
    • "System configuration" → "System"
    • "Network configuration" → "Server Connection"
    • New "Provisioning & Hotspot" subsection
  • Each subsection also gained a "Docs" button linking into /manage/reference/viam-agent/ at specific anchors (#version-control, #system-configuration, #advanced-settings).

Docs changes

  • docs/fleet/system-settings.md: update the five references to the old subsection labels to use the new labels and the Settings > subsection navigation path.
  • docs/manage/reference/viam-agent/_index.md: add custom anchor IDs {#version-control} and {#advanced-settings} so the new UI "Docs" buttons land on the correct sections. The #system-configuration anchor already matches the existing heading slug and needs no change.
  • docs/operate/reference/viam-server/_index.md and docs/operate/reference/viam-server/manage-viam-server.md: update the three existing internal links that used the long auto-generated slug to use the new #version-control anchor.

How I found these

  • Grep for Viam agent version control, Agent advanced settings, Network management and hotspot, System configuration across the docs repo.
  • Followed the new UI docs links in the source diff to their anchor targets and verified the existing headings would not match.
  • Cross-referenced existing internal links to viam-agent/#version_control-... so they could be updated at the same time.

Generated by daily docs change agent

The Machine Settings card was redesigned in viamrobotics/app#11640
(APP-15678). Settings are now organized into collapsible subsections
under a top-level Settings section:

- "Viam agent version control" is now "Software Updates"
- "Agent advanced settings" is now "Advanced"
- "Networks" is now "Known Networks"
- "System configuration" is now "System"

Update docs/fleet/system-settings.md to reference the new section
names and the Settings > subsection navigation.

The new UI also adds "Docs" buttons on the Software Updates, Provisioning
& Hotspot, System, and Advanced subsections that link to anchors in
docs/manage/reference/viam-agent/_index.md. Add custom anchor IDs
{#version-control} and {#advanced-settings} so those buttons land on
the correct section instead of the top of the page. The #system-configuration
anchor already matches the existing heading slug.

Update the three existing internal links that used the long auto-
generated slug for version_control to use the new short anchor.
@netlify
Copy link
Copy Markdown

netlify bot commented Apr 10, 2026

Deploy Preview for viam-docs ready!

Name Link
🔨 Latest commit 24b71e9
🔍 Latest deploy log https://app.netlify.com/projects/viam-docs/deploys/69d934c05208d300086ebb1c
😎 Deploy Preview https://deploy-preview-4898--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 (🔴 down 5 from production)
Accessibility: 99 (🔴 down 1 from production)
Best Practices: 83 (🔴 down 9 from production)
SEO: 89 (🔴 down 3 from production)
PWA: 60 (🔴 down 10 from production)
View the detailed breakdown and full score reports

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

Copy link
Copy Markdown
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Updates docs to match the redesigned Machine Settings card layout and ensures the new UI “Docs” buttons deep-link to stable anchors in the viam-agent reference.

Changes:

  • Update internal links in viam-server docs to use the new viam-agent #version-control anchor.
  • Add explicit anchor IDs for version_control and advanced_settings sections in the viam-agent reference.
  • Refresh Fleet “System settings” instructions to reference the new Settings > navigation labels.

Reviewed changes

Copilot reviewed 4 out of 4 changed files in this pull request and generated 2 comments.

File Description
docs/operate/reference/viam-server/manage-viam-server.md Updates links to the version_control section to use #version-control.
docs/operate/reference/viam-server/_index.md Updates the maintenance-window bullet link to use #version-control.
docs/manage/reference/viam-agent/_index.md Adds custom anchor IDs for version_control and advanced_settings headings.
docs/fleet/system-settings.md Updates UI navigation instructions to the new Settings subsections (Software Updates/Advanced/Known Networks/System).

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Comment thread docs/manage/reference/viam-agent/_index.md
Comment thread docs/manage/reference/viam-agent/_index.md
shannonbradshaw and others added 3 commits April 10, 2026 13:26
Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
Fixes MD022 and prettier failures introduced by adding backward-compat
<a id="..."> tags directly adjacent to the ## headings.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
@shannonbradshaw shannonbradshaw merged commit 6723303 into new-docs-site Apr 13, 2026
12 checks passed
@shannonbradshaw shannonbradshaw deleted the claude/update-machine-settings-redesign branch April 13, 2026 13:29
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.

3 participants