Skip to content

docs: fix quick start feedback items from review#231

Open
Keinberger wants to merge 1 commit intomainfrom
kbg/docs/quick-start-feedback-fixes
Open

docs: fix quick start feedback items from review#231
Keinberger wants to merge 1 commit intomainfrom
kbg/docs/quick-start-feedback-fixes

Conversation

@Keinberger
Copy link
Copy Markdown
Collaborator

Summary

Addresses remaining Quick Start feedback from Dominik's review (miden-devrel#126). Brian's PRs #219-227 covered the first batch; this covers the rest.

Changes across 10 files (5 in docs/ for next version + 5 mirrored in versioned_docs/version-0.13/ for current live):

  • installation.md: add cd my-test-project after project creation
  • accounts.md: add "reuse existing project" guidance before miden new
  • notes.md: add transaction principle, fix "private" wording, add code navigation tips, add polling explanation comments, fix "Bob's account" → "Bob's client"
  • create.md: fix "Miden assembly" → "Miden package (.masp file)", add felt! explanation, clarify "Account component" with link, add "in the counter contract"
  • deploy.md: add Miden Testnet Explorer link, fix "Miden assembly" description

Pre-existing issues noted (not fixed here)

  • newFaucet() inline comment in accounts.md/notes.md says "Mutable" but param is non_fungible
  • Missing yarn install step after create-miden-app in accounts.md TypeScript setup

Test plan

  • npm run build passes with no new broken links
  • All code snippets verified against current project-template and miden-frontend-template
  • Contract code blocks match template source exactly
  • TypeScript API signatures verified against @miden-sdk/miden-sdk type definitions
  • Independent end-to-end verification of all 17 change points

Address feedback from Dominik's Quick Start review (miden-devrel#126):

- Add missing `cd my-test-project` after project creation in installation guide
- Add conditional "reuse existing project" note in accounts guide
- Add core transaction principle to Two-Transaction Model section
- Fix "private asset transfers" wording to match public NoteType usage
- Add tip blocks and section markers for duplicated code in notes guide
- Add polling loop explanation comments (notes must be committed first)
- Fix "Bob's account" to "Bob's client" for technical accuracy
- Fix "Miden assembly" to "Miden package (.masp file)" in contract guides
- Add felt! macro vs Felt type explanation
- Clarify "Miden component" as "Account component" with link
- Add "in the counter contract" for clarity
- Add Miden Testnet Explorer link after deployment
@Keinberger Keinberger requested a review from BrianSeong99 March 25, 2026 11:29
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