Hacktoberfest 2026: le issue che i maintainer hanno segnato per ottobre, aperte e adatte ai principianti. Sfoglia le issue Hacktoberfest

Add Default Cardano developer environment how-to guide

Aperta
#264 1 commento 0 reazioni 0 assegnatari Vedi su GitHub

I maintainer di solito rispondono entro 1 giorno

Nessuno ha ancora preso questa issue.

Valutazione

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

Direzione di ricerca

Inizia esaminando i contenuti esistenti in website/docs/how-to-guide/, la pagina Getting Started, il README per principianti e le note correlate di Session 17. Redigi la guida dell’ambiente predefinito rivolta ai nuovi utenti, collegala dai punti di ingresso richiesti ed esegui npm run build. Il lavoro è completato quando la pagina è pubblicata, i collegamenti sono presenti, i passaggi coprono i controlli di successo indicati e il percorso di progressione, e la build va a buon fine.

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

Descrizione

documentation enhancement High Priority stale

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)
Lingua principale
TypeScript
Stelle
13
Fork
22
Merge medio
19h 1m
PR unite (30g)
10

Preparare l'ambiente

Come iniziare

  1. Leggi tutta la issue e poi la guida ai contributi del progetto.
  2. Commenta sulla issue per dire che te ne occupi tu — evita che due persone facciano lo stesso lavoro.
  3. Fai un fork del repository e lavora su un branch.
  4. Apri una pull request che faccia riferimento al numero della issue.

Altre issue di IntersectMBO/developer-experience

Tutte le issue di IntersectMBO/developer-experience

Issue simili

Altre issue su TypeScript

Ricevi le nuove issue nella tua casella

Un breve riepilogo di issue GitHub adatte ai principianti.