Suggestion: clearer entry path for non-technical newcomers
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
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
- Aucun Dockerfile ni fichier Docker Compose
- Propose un modèle de pull request
- Lire le guide de contribution
Par où commencer
- Lisez l'issue en entier, puis le guide de contribution du projet.
- Signalez en commentaire que vous la prenez — cela évite que deux personnes fassent le même travail.
- Forkez le dépôt et travaillez sur une branche.
- Ouvrez une pull request qui référence le numéro de l'issue.
Autres issues de ipfs/ipfs-docs
-
kind/suggestion need/triage
Difficulté 1/5 1-3 heures Accessibilité débutants 65/100
-
Difficulté 1/5 Moins d'une heure Accessibilité débutants 65/100
-
IPFS - Abuse Report Help?Ouverteneed/triage
Difficulté 5/5 Plus d'une semaine Accessibilité débutants 5/100
-
Digital Bayanihan ChainOuverte
Difficulté 3/5 1-2 jours Accessibilité débutants 15/100
-
better gov phOuverte
Difficulté 5/5 Plus d'une semaine Accessibilité débutants 10/100
Toutes les issues de ipfs/ipfs-docs
Issues similaires
-
area/networking kind/bug
Difficulté 2/5 1-3 heures Accessibilité débutants 69/100
siderolabs/talos#14972 ·
Les mainteneurs répondent en général sous 1 jour
-
Difficulté 1/5 Moins d'une heure Accessibilité débutants 72/100
Les mainteneurs répondent en général sous 1 jour
-
kubectl wait outputs cryptic "error: unrecognized condition: []" when --for is omittedPeut-être pris @muskan-creates352 l’a pris aujourd’hui. Ouvertekind/bug needs-triage
Difficulté 2/5 1-3 heures Accessibilité débutants 84/100
kubernetes/kubectl#1910 · 1 commentaire ·
-
Add Shiro (Remote) MCP serverOuverteneeds-triage
Difficulté 2/5 1-3 heures Accessibilité débutants 66/100
stacklok/toolhive-catalog#1967 ·
Les mainteneurs répondent en général sous 1 jour
-
Difficulté 2/5 1-3 heures Accessibilité débutants 66/100
unbound-force/gaze#353 ·
Les mainteneurs répondent en général sous 1 jour