Update machine settings card labels for new layout#4898
Merged
shannonbradshaw merged 4 commits intonew-docs-sitefrom Apr 13, 2026
Merged
Update machine settings card labels for new layout#4898shannonbradshaw merged 4 commits intonew-docs-sitefrom
shannonbradshaw merged 4 commits intonew-docs-sitefrom
Conversation
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.
✅ Deploy Preview for viam-docs ready!
To edit notification comments on pull requests, go to your Netlify project configuration. |
Contributor
There was a problem hiding this comment.
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-serverdocs to use the newviam-agent#version-controlanchor. - Add explicit anchor IDs for
version_controlandadvanced_settingssections in theviam-agentreference. - 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.
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>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.

Source changes
CardLayoutwas replaced with a nestedCardSectionhierarchy. Settings are now collapsible subsections under a top-level Settings section, plus a separate Details section./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-configurationanchor already matches the existing heading slug and needs no change.docs/operate/reference/viam-server/_index.mdanddocs/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-controlanchor.How I found these
Viam agent version control,Agent advanced settings,Network management and hotspot,System configurationacross the docs repo.viam-agent/#version_control-...so they could be updated at the same time.Generated by daily docs change agent