Skip to content

docs: fix quick start feedback items from review#231

Merged
Keinberger merged 1 commit intomainfrom
kbg/docs/quick-start-feedback-fixes
Apr 8, 2026
Merged

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

Conversation

@Keinberger
Copy link
Copy Markdown
Collaborator

@Keinberger Keinberger commented Mar 25, 2026

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
@Keinberger Keinberger merged commit 286630d into main Apr 8, 2026
4 checks passed
@Keinberger Keinberger deleted the kbg/docs/quick-start-feedback-fixes branch April 8, 2026 16:11
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.

2 participants