Suggestion: clearer entry path for non-technical newcomers
Nadie ha tomado este issue todavía.
Evaluación
- Dificultad
- 4/5
- Tiempo estimado
- 3-5 días
- Aptitud para principiantes
- 38/100
- Tipo de issue
- Documentación
- Claridad
- Bastante claro
- Estado de actividad
- Estancado
- Área
- documentation
Línea de trabajo
Revisa la documentación existente de IPFS e identifica dónde podría encajar una breve sección de introducción para quienes son nuevos. Comprueba si las páginas actuales de descripción general de alto nivel y las indicaciones para contribuidores cubren a la audiencia propuesta. Se considera terminado cuando se haya añadido un punto de partida claro que explique IPFS a alto nivel, enlace a 2–3 páginas de descripción general y describa formas no técnicas de contribuir.
Escrito por el modelo de indexación a partir del texto del issue.
Descripción
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.
- Lenguaje dominante
- Go
- Estrellas
- 334
- Forks
- 503
- Métricas de merge de PR
- Sin PR fusionados en 30 d
Preparar el entorno
- Sin Dockerfile ni archivo de Docker Compose
- Tiene una plantilla de pull request
- Leer la guía de contribución
Primeros pasos
- Lee el issue completo y luego la guía de contribución del proyecto.
- Comenta en el issue que vas a ocuparte — evita que dos personas hagan lo mismo.
- Haz un fork del repositorio y trabaja en una rama.
- Abre un pull request que haga referencia al número del issue.
Más de ipfs/ipfs-docs
-
kind/suggestion need/triage
Dificultad 1/5 1-3 horas Aptitud para principiantes 65/100
-
Dificultad 1/5 Menos de una hora Aptitud para principiantes 65/100
-
IPFS - Abuse Report Help?Abiertoneed/triage
Dificultad 5/5 Más de una semana Aptitud para principiantes 5/100
-
Digital Bayanihan ChainAbierto
Dificultad 3/5 1-2 días Aptitud para principiantes 15/100
-
better gov phAbierto
Dificultad 5/5 Más de una semana Aptitud para principiantes 10/100
Todos los issues de ipfs/ipfs-docs
Issues similares
-
Dificultad 2/5 1-3 horas Aptitud para principiantes 80/100
blinklabs-io/gouroboros#3026 ·
Los mantenedores suelen responder en 1 día
-
bug
Dificultad 2/5 1-3 horas Aptitud para principiantes 70/100
AvengeMedia/DankMaterialShell#4291 ·
-
[Bug]: autoexport rejects OTEL_*_EXPORTER values that differ only in casePosiblemente ocupada @yuminn-k la tomó hoy. Abierto
Dificultad 2/5 1-3 horas Aptitud para principiantes 79/100
open-telemetry/opentelemetry-go-contrib#10291 ·
Los mantenedores suelen responder en 1 día
-
Dificultad 2/5 1-3 horas Aptitud para principiantes 62/100
podman-container-tools/skopeo#3041 ·
Los mantenedores suelen responder en 1 día
-
Dificultad 2/5 1-3 horas Aptitud para principiantes 85/100
Los mantenedores suelen responder en 1 día