Hacktoberfest 2026 : les issues que les mainteneurs ont marquées pour octobre, ouvertes et accessibles aux débutants. Parcourir les issues Hacktoberfest

Add Default Cardano developer environment how-to guide

Ouverte
#264 1 commentaire 0 réactions 0 personnes assignées Voir sur GitHub

Les mainteneurs répondent en général sous 1 jour

Personne n'a encore pris cette issue.

Évaluation

Difficulté
3/5
Temps estimé
1-2 jours
Accessibilité débutants
68/100
Type d'issue
Documentation
Clarté
Plutôt claire
Activité
Active
Domaine
documentation

Piste de recherche

Commencez par examiner le contenu existant sous website/docs/how-to-guide/, la page Getting Started, le README pour débutants et les notes associées de Session 17. Rédigez le guide de l’environnement par défaut destiné aux nouveaux contributeurs, ajoutez-y un lien depuis les points d’entrée demandés et exécutez npm run build. Le travail est terminé lorsque la page est publiée, que les liens sont présents, que les étapes couvrent les vérifications de réussite indiquées ainsi que le parcours de progression, et que le build réussit.

Rédigé par le modèle d'indexation à partir du texte de l'issue.

Description

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)
Langage dominant
TypeScript
Étoiles
13
Forks
23
Merge moyen
1 j 8 h
PR mergées (30 j)
16

Préparer son environnement

Par où commencer

  1. Lisez l'issue en entier, puis le guide de contribution du projet.
  2. Signalez en commentaire que vous la prenez — cela évite que deux personnes fassent le même travail.
  3. Forkez le dépôt et travaillez sur une branche.
  4. Ouvrez une pull request qui référence le numéro de l'issue.

Autres issues de IntersectMBO/developer-experience

Toutes les issues de IntersectMBO/developer-experience

Issues similaires

Plus d'issues TypeScript

Recevez les nouvelles issues par e-mail

Un résumé court des issues GitHub adaptées aux débutants.