IntersectMBO / IntersectMBO/developer-experience

Add Default Cardano developer environment how-to guide

Offen
#264 1 Kommentar 0 Reaktionen 0 zugewiesene Personen Auf GitHub ansehen
documentation enhancement High Priority stale
Vorherrschende Sprache
TypeScript
Sterne
13
Forks
22
Ø Merge
18 Std. 40 Min.
Gemergte PRs (30 T.)
11

Beschreibung

## 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)

Beitragsleitfaden

Beitragsleitfaden öffnen

Rechercherichtung

Beginne damit, die bestehenden Inhalte unter website/docs/how-to-guide/, die Getting Started-Seite, das Anfänger-README und die zugehörigen Notizen zu Session 17 zu prüfen. Erstelle den auf Neueinsteiger ausgerichteten Leitfaden für die Standardumgebung, verlinke ihn von den angeforderten Einstiegspunkten und führe npm run build aus. Erledigt bedeutet, dass die Seite veröffentlicht ist, die Links vorhanden sind, die Schritte die angegebenen Erfolgskriterien und den weiteren Entwicklungsweg abdecken und der Build erfolgreich ist.

Vom Indexierungsmodell aus dem Issue-Text verfasst.

Bewertung

Bereich
documentation
Issue-Typ
Dokumentation
Schwierigkeit
3/5
Geschätzter Aufwand
1-2 Tage
Aktivitätsstatus
Aktiv
Klarheit
Größtenteils klar
Anfängerfreundlichkeit
68/100

Neue Issues direkt in Ihr Postfach

Eine kurze Übersicht über anfängerfreundliche GitHub-Issues.