Skip to content

first-machine: add step 8 to add hardware in the CONFIGURE tab#5034

Open
shannonbradshaw wants to merge 1 commit into
viamrobotics:mainfrom
shannonbradshaw:shannonbradshaw/first-machine-step-8
Open

first-machine: add step 8 to add hardware in the CONFIGURE tab#5034
shannonbradshaw wants to merge 1 commit into
viamrobotics:mainfrom
shannonbradshaw:shannonbradshaw/first-machine-step-8

Conversation

@shannonbradshaw
Copy link
Copy Markdown
Collaborator

Summary

Adds a step 8 to /set-up-a-machine/first-machine/ that points users at the CONFIGURE tab to add the hardware they want to use. The walkthrough previously ended at step 7 ("Connect with code") and pushed hardware configuration into a "What's next" link, but a machine that is online with no components configured is not yet useful — adding hardware belongs inside the first-machine flow.

Changes

  • New step 8 "Add hardware in the CONFIGURE tab" between step 7 and "What's next." Brief, action-oriented: click +, select Component, search for the model, name, fill attributes, save. Links to /hardware/configure-hardware/ for the deep walkthrough rather than duplicating it.
  • Removed the now-redundant "Configure hardware" bullet from "What's next" (the link now lives in step 8).

Test plan

  • /set-up-a-machine/first-machine/ renders step 8 between step 7 and "What's next."
  • The link to /hardware/configure-hardware/ resolves on the deploy preview.

Note for review

I kept the existing order (step 7 Connect, then step 8 Add hardware) per the request. The reverse order (Add hardware → Connect with code) would let the SDK code sample see the configured resources, which is arguably the more natural flow. Happy to swap if preferred.

The walkthrough ended at step 7 (Connect with code), then sent users to a
"What's next" link to configure hardware. But adding hardware is part of
the first-machine flow, not a follow-up: a machine that is online but has
no components configured is not yet useful.

Adds step 8 as a brief, action-oriented step that points at the CONFIGURE
tab and walks through the per-component flow (click +, select Component,
search for the model, name, configure attributes). Links to
/hardware/configure-hardware/ for the deep walkthrough rather than
duplicating it inline.

Removes the now-redundant "Configure hardware" bullet from What's next.
@netlify
Copy link
Copy Markdown

netlify Bot commented Apr 29, 2026

Deploy Preview for viam-docs ready!

Name Link
🔨 Latest commit 9ab4ef6
🔍 Latest deploy log https://app.netlify.com/projects/viam-docs/deploys/69f267a457fe870008b47454
😎 Deploy Preview https://deploy-preview-5034--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 (🟢 up 5 from production)
Accessibility: 99 (no change from production)
Best Practices: 83 (no change 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 Apr 29, 2026
@viamrobotics-overwatch
Copy link
Copy Markdown

Hey @shannonbradshaw — CI is green and no reviewer is assigned yet. Could you request one when you have a chance?

Auto-comment from overwatch. Will not re-nudge for 7 days.

3 similar comments
@viamrobotics-overwatch
Copy link
Copy Markdown

Hey @shannonbradshaw — CI is green and no reviewer is assigned yet. Could you request one when you have a chance?

Auto-comment from overwatch. Will not re-nudge for 7 days.

@viamrobotics-overwatch
Copy link
Copy Markdown

Hey @shannonbradshaw — CI is green and no reviewer is assigned yet. Could you request one when you have a chance?

Auto-comment from overwatch. Will not re-nudge for 7 days.

@viamrobotics-overwatch
Copy link
Copy Markdown

Hey @shannonbradshaw — CI is green and no reviewer is assigned yet. Could you request one when you have a chance?

Auto-comment from overwatch. Will not re-nudge for 7 days.

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