Suggestion: clearer entry path for non-technical newcomers

Offen
#2,228 0 Kommentare 0 Reaktionen 0 zugewiesene Personen Auf GitHub ansehen

Dieses Issue hat noch niemand übernommen.

Bewertung

Schwierigkeit
4/5
Geschätzter Aufwand
3-5 Tage
Anfängerfreundlichkeit
38/100
Issue-Typ
Dokumentation
Klarheit
Größtenteils klar
Aktivitätsstatus
Veraltet
Bereich
documentation

Rechercherichtung

Überprüfe die vorhandene IPFS-Dokumentation und ermittle, wo ein kurzer Einstiegsabschnitt für Neueinsteiger passen könnte. Prüfe, ob die aktuellen Übersichtsseiten auf hoher Ebene und die Hinweise für Mitwirkende die vorgeschlagene Zielgruppe abdecken. Als abgeschlossen gilt die Aufgabe, wenn ein klarer Einstiegspunkt hinzugefügt wurde, der IPFS auf hoher Ebene erklärt, auf 2–3 Übersichtsseiten verlinkt und nichttechnische Möglichkeiten zur Mitarbeit beschreibt.

Vom Indexierungsmodell aus dem Issue-Text verfasst.

Beschreibung

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.

Vorherrschende Sprache
Go
Sterne
334
Forks
503
PR-Merge-Kennzahlen
Keine gemergten PRs in 30 T.

Entwicklungsumgebung

Erste Schritte

  1. Lesen Sie das ganze Issue und danach den Beitragsleitfaden des Projekts.
  2. Schreiben Sie ins Issue, dass Sie es übernehmen — das erspart doppelte Arbeit.
  3. Forken Sie das Repository und arbeiten Sie in einem Branch.
  4. Öffnen Sie einen Pull Request, der die Issue-Nummer nennt.

Mehr aus ipfs/ipfs-docs

Alle Issues in ipfs/ipfs-docs

Ähnliche Issues

Weitere Issues zu Go

Neue Issues direkt in Ihr Postfach

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