Suggestion: clearer entry path for non-technical newcomers

オープン
#2,228 コメント 0 件 リアクション 0 件 担当者 0 名 GitHub で見る

まだ誰も着手していません。

評価

難易度
4/5
見積もり時間
3〜5日
初心者へのやさしさ
38/100
issue の種類
ドキュメント
明瞭さ
おおむね明確
活発さ
停滞
領域
documentation

調査の方向性

既存の IPFS ドキュメントを確認し、新規ユーザー向けの短い導入セクションを配置できそうな場所を特定します。現在の高レベルの概要ページとコントリビューター向けガイダンスが、想定している対象者をカバーしているか確認します。IPFS を高レベルで説明し、2–3 件の概要ページへのリンクを掲載し、技術的でない貢献方法を説明する、明確な出発点が追加されれば完了です。

索引モデルが issue の本文から書いたものです。

説明

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.

主要言語
Go
スター
334
フォーク
503
PR マージ指標
30日以内にマージされた PR はありません

環境構築

はじめの一歩

  1. issue を最後まで読み、次にプロジェクトのコントリビューションガイドを読みます。
  2. 着手することを issue にコメントします — 二人が同じ作業をするのを防げます。
  3. リポジトリをフォークし、ブランチを切って変更します。
  4. issue 番号を参照したプルリクエストを送ります。

ipfs/ipfs-docs のほかの issue

ipfs/ipfs-docs の issue をすべて見る

似ている issue

Go の issue をもっと見る

新しい issue をメールで受け取る

初心者向けの GitHub issue を短くまとめたダイジェスト。