Suggestion: clearer entry path for non-technical newcomers
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ả
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
- Không có Dockerfile hay tệp Docker Compose
- Có mẫu pull request
- Đọc hướng dẫn đóng góp
Bắt đầu từ đâu
- Đọc hết issue, rồi đọc hướng dẫn đóng góp của dự án.
- 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.
- Fork repository và làm thay đổi trên một nhánh.
- Mở pull request có tham chiếu số hiệu của issue.
Issue khác của ipfs/ipfs-docs
-
kind/suggestion need/triage
Độ khó 1/5 1-3 giờ Mức phù hợp với người mới 65/100
-
Độ khó 1/5 Dưới một giờ Mức phù hợp với người mới 65/100
-
IPFS - Abuse Report Help?Đang mởneed/triage
Độ khó 5/5 Hơn một tuần Mức phù hợp với người mới 5/100
-
Digital Bayanihan ChainĐang mở
Độ khó 3/5 1-2 ngày Mức phù hợp với người mới 15/100
-
better gov phĐang mở
Độ khó 5/5 Hơn một tuần Mức phù hợp với người mới 10/100
Tất cả issue của ipfs/ipfs-docs
Issue tương tự
-
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 80/100
blinklabs-io/gouroboros#3026 ·
Maintainer thường phản hồi trong vòng 1 ngày
-
bug
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 70/100
AvengeMedia/DankMaterialShell#4291 ·
-
[Bug]: autoexport rejects OTEL_*_EXPORTER values that differ only in caseCó thể đã có người làm @yuminn-k đã nhận hôm nay. Đang mở
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 79/100
open-telemetry/opentelemetry-go-contrib#10291 ·
Maintainer thường phản hồi trong vòng 1 ngày
-
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 62/100
podman-container-tools/skopeo#3041 ·
Maintainer thường phản hồi trong vòng 1 ngày
-
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 85/100
Maintainer thường phản hồi trong vòng 1 ngày