Skip to content

docs(dtu): correct CLI references and flow in dtu.md#3

Merged
michaeljabbour merged 1 commit intomainfrom
docs/dtu-corrections-from-mac-walkthrough
Apr 30, 2026
Merged

docs(dtu): correct CLI references and flow in dtu.md#3
michaeljabbour merged 1 commit intomainfrom
docs/dtu-corrections-from-mac-walkthrough

Conversation

@michaeljabbour
Copy link
Copy Markdown
Owner

Summary

This PR corrects four factual errors in the Digital Twin Universe developer guide that prevented it from working end-to-end on macOS.

Closes #2 (documents the DTU profile introduced in @colombod's PR #2).

What was corrected

  • amplifier-digital-twin installation: Changed from non-existent PyPI package to correct git repo URL
  • Missing amplifier-gitea prerequisite: Added the Gitea CLI installation step (was missing entirely)
  • One-Time Gitea Setup section: Replaced non-existent subcommands with correct amplifier-gitea create + mirror-from-github workflow
  • Launch invocation: Fixed profile path reference and replaced JSON-parsing pattern with explicit --name flag; added note about localhost auto-rewrite

Test plan

✅ End-to-end walkthrough on macOS (Colima 0.10.1, Incus 6.0.0 in-VM)
✅ All 7 smoke tests passing on corrected steps
✅ Doc-only change — no code changes, no version bump needed

Generated with Amplifier

Co-Authored-By: Amplifier 240397093+microsoft-amplifier@users.noreply.github.com

Verified end-to-end on macOS (Colima 0.10.1, Incus 6.0.0 in-VM) with
all 7 smoke tests passing. Four factual errors prevented the existing
guide from working as written:

- amplifier-digital-twin: install from git repo, not PyPI
- amplifier-gitea: was never listed as a prerequisite
- One-Time Gitea Setup: replace non-existent subcommands and the
  manual curl-based migrate with amplifier-gitea create + mirror-from-github
- Launch: use the explicit profile path and the --name pattern instead
  of a tail-based JSON capture that didn't extract the id correctly

Doc-only change. No functional impact.

Generated with Amplifier

Co-Authored-By: Amplifier <240397093+microsoft-amplifier@users.noreply.github.com>
@michaeljabbour michaeljabbour merged commit 2ba94f7 into main Apr 30, 2026
2 checks passed
@michaeljabbour michaeljabbour deleted the docs/dtu-corrections-from-mac-walkthrough branch April 30, 2026 05:00
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.

1 participant