Skip to content

Update module reload --home flag docs for dynamic VIAM_HOME - #5266

Open
Shannon Bradshaw (shannonbradshaw) wants to merge 1 commit into
mainfrom
claude/update-module-reload-home-flag-docs
Open

Update module reload --home flag docs for dynamic VIAM_HOME#5266
Shannon Bradshaw (shannonbradshaw) wants to merge 1 commit into
mainfrom
claude/update-module-reload-home-flag-docs

Conversation

@shannonbradshaw

Copy link
Copy Markdown
Collaborator

Source changes

  • RSDK-14370: Fix windows paths for local module reload + other CLI rdk#6333: Fix Windows paths for local module reload. The --home flag on viam module reload-local changed behavior: it now queries the target machine for its VIAM_HOME directory via a shell service DoCommand, instead of defaulting to ~. The flag is now an override for when the query fails or returns a wrong value. The usage text also changed.

Docs changes

  • docs/cli/reference.md: Updated --home flag description from "Specify home directory for a remote machine where $HOME is not the default /root" to accurately describe the new behavior (CLI queries the machine for its VIAM_HOME; --home is an override). Also updated the reload-local description to note that the destination path depends on the machine's Viam home directory rather than hardcoding ~/.viam.
  • docs/build-modules/module-reference.md: Fixed --home-dir typo to --home (the actual flag name) and updated the description from "remote user's home directory" to "override the remote machine's home directory".
  • docs/build-modules/write-a-driver-module.md: Updated troubleshooting tips that incorrectly described --home as specifying the module directory. Now correctly describes --home as an override for the machine's Viam home directory, and points to --module for the meta.json path issue.

How I found these

  • Xref lookup: cli-xref.md pointed to docs/cli/reference.md
  • Grep matches: Found 3 additional files referencing --home or --home-dir in the context of module reload

Generated by daily docs change agent


Generated by Claude Code

The CLI's --home flag on `viam module reload-local` changed behavior:
it now queries the target machine for its VIAM_HOME directory via
a shell service DoCommand, instead of defaulting to ~. The flag is
now an override for when the query fails.

- cli/reference.md: Update --home description and reload-local path
- module-reference.md: Fix --home-dir typo to --home
- write-a-driver-module.md: Fix troubleshooting tips for --home

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01UeeUxjS46hfhDsAyxgky4J
@netlify

netlify Bot commented Aug 15, 2026

Copy link
Copy Markdown

Deploy Preview for viam-docs ready!

Name Link
🔨 Latest commit 2344543
🔍 Latest deploy log https://app.netlify.com/projects/viam-docs/deploys/6a802c9369d6af0008476225
😎 Deploy Preview https://deploy-preview-5266--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: 43 (🔴 down 3 from production)
Accessibility: 100 (no change from production)
Best Practices: 100 (🟢 up 8 from production)
SEO: 92 (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 Aug 15, 2026
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.

3 participants