Suggestion: clearer entry path for non-technical newcomers
まだ誰も着手していません。
評価
- 難易度
- 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 ファイルなし
- プルリクエストのテンプレートあり
- コントリビューションガイドを読む
はじめの一歩
- issue を最後まで読み、次にプロジェクトのコントリビューションガイドを読みます。
- 着手することを issue にコメントします — 二人が同じ作業をするのを防げます。
- リポジトリをフォークし、ブランチを切って変更します。
- issue 番号を参照したプルリクエストを送ります。
ipfs/ipfs-docs のほかの issue
-
kind/suggestion need/triage
難易度 1/5 1〜3時間 初心者へのやさしさ 65/100
-
難易度 1/5 1時間未満 初心者へのやさしさ 65/100
-
need/triage
難易度 5/5 1週間以上 初心者へのやさしさ 5/100
-
難易度 3/5 1〜2日 初心者へのやさしさ 15/100
-
better gov phオープン
難易度 5/5 1週間以上 初心者へのやさしさ 10/100
似ている issue
-
難易度 2/5 1〜3時間 初心者へのやさしさ 80/100
blinklabs-io/gouroboros#3026 ·
メンテナーはふだん 1 日以内に返信
-
bug
難易度 2/5 1〜3時間 初心者へのやさしさ 70/100
AvengeMedia/DankMaterialShell#4291 ·
-
[Bug]: autoexport rejects OTEL_*_EXPORTER values that differ only in case対応中かも @yuminn-k が今日担当しました。 オープン
難易度 2/5 1〜3時間 初心者へのやさしさ 79/100
open-telemetry/opentelemetry-go-contrib#10291 ·
メンテナーはふだん 1 日以内に返信
-
難易度 2/5 1〜3時間 初心者へのやさしさ 62/100
podman-container-tools/skopeo#3041 ·
メンテナーはふだん 1 日以内に返信
-
難易度 2/5 1〜3時間 初心者へのやさしさ 85/100
メンテナーはふだん 1 日以内に返信