Bug 15974

Summary: Update Yocto Project compatible instructions to explain it must be run as one command against all machines
Product: [Documentation] General Docs Reporter: Mark Hatle <mark.hatle>
Component: docs-generalAssignee: Antonin Godard <antonin.godard>
Status: RESOLVED FIXED QA Contact:
Severity: normal    
Priority: Medium+ CC: denis, kexin.hao, mingli.yu, randy.macleod
Version: unspecified   
Target Milestone: 5.3 M4   
Hardware: All   
OS: Multiple   
Whiteboard:
OS type for building Yocto: --- Type of Regression: ---
Verified: Documentation change: Yes (doc changes required)

Description Mark Hatle 2025-09-15 15:48:56 UTC 
All machines within a layer should be run against a single command run.

A common issue seems to be that users have interpreted current instructions as run the command one for each machine, but this won't be able to catch the case where two machines conflict with the recipe hashes.

Instead instructions should state that the script be run with all of the machines within the layer to be tested.
Comment 1 Randy MacLeod 2025-09-18 14:32:47 UTC 
CCing some WR devs as an FYI.
Comment 2 Randy MacLeod 2025-09-18 14:33:38 UTC 
Richard says we may need to fix the YP autobuilder as well.
Comment 3 Denys Dmytriyenko 2025-09-27 16:21:04 UTC 
There's a blocker for this requirement:
https://bugzilla.yoctoproject.org/show_bug.cgi?id=15982
Comment 4 Antonin Godard 2025-10-23 08:30:52 UTC 
A patch was merged recently to mention this option in the docs:
https://git.yoctoproject.org/yocto-docs/commit/?id=2cd7b5c83978819179b8a47e213b9812b97d5720

And --dependency was missing too so it's part the above patch.

Docs-wise we're good, so I'm closing this bug, while https://bugzilla.yoctoproject.org/show_bug.cgi?id=15982 will track the blocker.