Suggestion: clearer entry path for non-technical newcomers
还没有人认领这个 Issue。
评估
- 难度
- 4/5
- 预计耗时
- 3-5 天
- 新手友好度
- 38/100
- Issue 类型
- 文档
- 描述清晰度
- 基本清楚
- 活跃度
- 停滞
调研方向
审查现有的 IPFS 文档,并确定适合加入简短新手入门部分的位置。检查当前的高层概览页面和贡献者指南是否涵盖了拟议的目标受众。完成的标准是添加一个清晰的起点,用高层次的方式解释 IPFS,链接到 2–3 个概览页面,并介绍非技术性的贡献途径。
由索引模型根据 Issue 内容生成。
描述
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.
- 主要语言
- Go
- 星标
- 334
- 派生
- 503
- PR 合并指标
- 30 天内没有已合并 PR
环境准备
- 没有 Dockerfile 或 Docker Compose 文件
- 有 Pull Request 模板
- 阅读贡献指南
从这里开始
- 先读完整个 Issue,再读项目的贡献指南。
- 在 Issue 下留言说明你要接手 —— 这能避免两个人做同样的事。
- Fork 仓库,在一个分支上完成修改。
- 提交 Pull Request,并在描述里引用这个 Issue 编号。
ipfs/ipfs-docs 的其他 Issue
-
kind/suggestion need/triage
难度 1/5 1-3 小时 新手友好度 65/100
-
难度 1/5 1 小时以内 新手友好度 65/100
-
need/triage
难度 5/5 一周以上 新手友好度 5/100
-
难度 3/5 1-2 天 新手友好度 15/100
-
better gov ph未关闭
难度 5/5 一周以上 新手友好度 10/100
相似的 Issue
-
affects-8.5 component/session severity/moderate sig/transaction type/bug
难度 2/5 1-3 小时 新手友好度 72/100
维护者通常 1 天内回复
-
enhancement good first issue
难度 2/5 1-3 小时 新手友好度 85/100
维护者通常 1 天内回复
-
难度 2/5 1-3 小时 新手友好度 72/100
harvester/harvester#12311 · 1 条评论 ·
维护者通常 1 天内回复
-
verifyrun --bracket-digest --credit: relative --witness is could-not-check, absolute path credits未关闭bug effort:s impact:low raised-by:desk risk:low
难度 2/5 1-3 小时 新手友好度 62/100
medici-finance/assay#6580 · 1 条评论 ·
维护者通常 1 天内回复
-
难度 2/5 1-3 小时 新手友好度 80/100
blinklabs-io/gouroboros#3026 ·
维护者通常 1 天内回复