IntersectMBO / IntersectMBO/developer-experience

Add Default Cardano developer environment how-to guide

Aperta
#264 1 commento 0 reazioni 0 assegnatari Vedi su GitHub
documentation enhancement High Priority stale
Lingua principale
TypeScript
Stelle
13
Fork
22
Merge medio
18h 40m
PR unite (30g)
11

Descrizione

## Problem
Newcomers still lack a durable, opinionated **default local developer environment** guide on the DevEx site. Working Group Session 17 discussed local vs public testnets and tools like Yaci DevKit, but that content mostly lives in session notes rather than a first-class how-to.

The Intermediate how-to section was empty and removed (#191), which widens this gap between Beginner and Advanced.

## Proposed solution
Publish a practical how-to under `website/docs/how-to-guide/` that covers:

1. Recommended default path for new builders (local-first where possible)
2. Setup steps (e.g. Yaci DevKit / local devnet + indexer options)
3. First success checks (query tip, faucet/test ADA, simple submit path)
4. Graduation path to preview/preprod/mainnet
5. Links out to Developer Portal / Mesh / Blockfrost as needed

Link the guide from Getting Started and Beginner README.

## Acceptance criteria
- [ ] New how-to page published (not only WG session notes)
- [ ] Linked from Getting Started (and beginner index where appropriate)
- [ ] Written for newcomers (clear steps, minimal jargon)
- [ ] `npm run build` succeeds

## Related
- Session 17 notes (Default Developer Environment)
- #115 (missing onboarding content)
- #201 (pathway gaps; this is a smaller concrete slice)

Guida per i contributori

Apri la guida per i contributori

Direzione di ricerca

Start by reviewing the existing content under website/docs/how-to-guide/, the Getting Started page, the beginner README, and the related Session 17 notes. Draft the newcomer-focused default environment guide, link it from the requested entry points, and run npm run build. Done means the page is published, links are present, steps cover the stated success checks and graduation path, and the build succeeds.

Scritto dal modello di indicizzazione a partire dal testo della issue.

Valutazione

Ambito
documentation
Tipo di issue
Documentazione
Difficoltà
3/5
Tempo stimato
1-2 giorni
Stato di attività
Attiva
Chiarezza
Abbastanza chiara
Idoneità per principianti
68/100

Ricevi le nuove issue nella tua casella

Un breve riepilogo di issue GitHub adatte ai principianti.