Suggestion: clearer entry path for non-technical newcomers

Ouverte
#2,228 0 commentaires 0 réactions 0 personnes assignées Voir sur GitHub

Personne n'a encore pris cette issue.

Évaluation

Difficulté
4/5
Temps estimé
3-5 jours
Accessibilité débutants
38/100
Type d'issue
Documentation
Clarté
Plutôt claire
Activité
À l'abandon
Domaine
documentation

Piste de recherche

Examinez la documentation IPFS existante et identifiez où une courte section d’introduction pour les nouveaux arrivants pourrait s’intégrer. Vérifiez si les pages actuelles de présentation générale et les indications destinées aux contributeurs couvrent le public visé. Le travail est considéré comme terminé lorsqu’un point de départ clair a été ajouté, qu’il explique IPFS à un niveau général, renvoie vers 2–3 pages de présentation générale et décrit des moyens non techniques de contribuer.

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

Description

kind/suggestion need/triage

I am new to IPFS and come from a non-technical background. I spent some time reading the documentation to understand the project at a high level.

The documentation is very comprehensive and detailed, which I really appreciate. However, as a first-time reader, I found it a bit unclear where non-technical contributors should begin.

I would like to suggest adding a short entry section such as:
“New to IPFS? Start here”

This section could:

  • Briefly explain what IPFS is trying to solve
  • Point readers to 2–3 high-level overview pages
  • Clarify how non-technical contributors (documentation, community, coordination) can get involved

I think this would make the documentation more welcoming for newcomers and help lower the entry barrier for people without a technical background.

Langage dominant
Go
Étoiles
334
Forks
503
Métriques de merge des PR
Aucune PR mergée en 30 j

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 ipfs/ipfs-docs

Toutes les issues de ipfs/ipfs-docs

Issues similaires

Plus d'issues Go

Recevez les nouvelles issues par e-mail

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