Suggestion: clearer entry path for non-technical newcomers

Đang mở
#2,228 0 bình luận 0 reaction 0 người được giao Xem trên GitHub

Chưa có ai nhận issue này.

Đánh giá

Độ khó
4/5
Thời gian dự kiến
3-5 ngày
Mức phù hợp với người mới
38/100
Loại issue
Tài liệu
Độ rõ ràng
Khá rõ ràng
Mức độ hoạt động
Đình trệ
Lĩnh vực
documentation

Hướng nghiên cứu

Rà soát tài liệu IPFS hiện có và xác định nơi có thể đặt một phần giới thiệu ngắn dành cho người mới. Kiểm tra xem các trang tổng quan cấp cao hiện tại và hướng dẫn dành cho người đóng góp có bao quát đối tượng đề xuất hay không. Được xem là hoàn tất khi đã thêm một điểm bắt đầu rõ ràng, giải thích IPFS ở cấp cao, liên kết đến 2–3 trang tổng quan và mô tả các cách đóng góp không mang tính kỹ thuật.

Do mô hình lập chỉ mục viết ra từ nội dung của issue.

Mô tả

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.

Ngôn ngữ chính
Go
Star
334
Fork
503
Chỉ số merge pull request
Không có pull request nào được merge trong 30 ngày

Chuẩn bị môi trường

Bắt đầu từ đâu

  1. Đọc hết issue, rồi đọc hướng dẫn đóng góp của dự án.
  2. Bình luận trên issue rằng bạn sẽ nhận — tránh hai người làm cùng một việc.
  3. Fork repository và làm thay đổi trên một nhánh.
  4. Mở pull request có tham chiếu số hiệu của issue.

Issue khác của ipfs/ipfs-docs

Tất cả issue của ipfs/ipfs-docs

Issue tương tự

Thêm issue về Go

Nhận issue mới trong hộp thư của bạn

Bản tóm tắt ngắn những issue GitHub phù hợp với người mới.