Suggestion: clearer entry path for non-technical newcomers
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
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
- Kein Dockerfile und keine Docker-Compose-Datei
- Hat eine Pull-Request-Vorlage
- Beitragsleitfaden lesen
Erste Schritte
- Lesen Sie das ganze Issue und danach den Beitragsleitfaden des Projekts.
- Schreiben Sie ins Issue, dass Sie es übernehmen — das erspart doppelte Arbeit.
- Forken Sie das Repository und arbeiten Sie in einem Branch.
- Öffnen Sie einen Pull Request, der die Issue-Nummer nennt.
Mehr aus ipfs/ipfs-docs
-
kind/suggestion need/triage
Schwierigkeit 1/5 1-3 Stunden Anfängerfreundlichkeit 65/100
-
Schwierigkeit 1/5 Unter einer Stunde Anfängerfreundlichkeit 65/100
-
need/triage
Schwierigkeit 5/5 Über eine Woche Anfängerfreundlichkeit 5/100
-
Digital Bayanihan ChainOffen
Schwierigkeit 3/5 1-2 Tage Anfängerfreundlichkeit 15/100
-
better gov phOffen
Schwierigkeit 5/5 Über eine Woche Anfängerfreundlichkeit 10/100
Ähnliche Issues
-
area/networking kind/bug
Schwierigkeit 2/5 1-3 Stunden Anfängerfreundlichkeit 69/100
siderolabs/talos#14972 ·
Maintainer antworten meist innerhalb von 1 Tag
-
Schwierigkeit 1/5 Unter einer Stunde Anfängerfreundlichkeit 72/100
Maintainer antworten meist innerhalb von 1 Tag
-
kubectl wait outputs cryptic "error: unrecognized condition: []" when --for is omittedEvtl. vergeben @muskan-creates352 hat das heute übernommen. Offenkind/bug needs-triage
Schwierigkeit 2/5 1-3 Stunden Anfängerfreundlichkeit 84/100
kubernetes/kubectl#1910 · 1 Kommentar ·
-
needs-triage
Schwierigkeit 2/5 1-3 Stunden Anfängerfreundlichkeit 66/100
stacklok/toolhive-catalog#1967 ·
Maintainer antworten meist innerhalb von 1 Tag
-
Schwierigkeit 2/5 1-3 Stunden Anfängerfreundlichkeit 66/100
unbound-force/gaze#353 ·
Maintainer antworten meist innerhalb von 1 Tag