Improve accessibility of project/tutorial project templates
Chưa có ai nhận issue này.
Đánh giá
- Độ khó
- 5/5
- Thời gian dự kiến
- Hơn một tuần
- Mức phù hợp với người mới
- 25/100
- Loại issue
- Tính năng
- Độ rõ ràng
- Cần làm rõ
- Mức độ hoạt động
- Đình trệ
- Công nghệ
- javascript, python, rust, wasm
- Lĩnh vực
- developer-experience, documentation, tooling
Hướng nghiên cứu
Bắt đầu bằng việc xem xét bố cục repository component-docs và đề xuất trong issue #219, sau đó so sánh các tùy chọn được mô tả ở đây: một repository cấp cao nhất duy nhất, các tarball Current-release và scaffolding dành riêng cho từng ngôn ngữ. Xác định một đường dẫn thiết lập đã được thống nhất cho các tài nguyên hướng dẫn và xác minh rằng đường dẫn đó bao quát các workflow Rust, JavaScript và Python được đề cập mà không yêu cầu người dùng điều hướng qua một thư mục con lồng nhau.
Do mô hình lập chỉ mục viết ra từ nội dung của issue.
Mô tả
Currently, new users must clone the component-docs repo, head to a specific sub-directory then attempt to build projects.
It would be ideal if there were easier ways to download and set up resources to walk through the tutorials.
While we probably want to avoid building custom tooling in every possible language (different languages have different scaffolding mechanisms), we need a solution that is a bit less nested.
There were several good suggestions made, one of which being a single repo that contains all the languages at the top level (thanks @mkatychev), which is a bit easier to clone and filter out.
Another suggestion is that this could actually be a part of #219 -- having a "Current" release that always contains tarballs of the current code for any given language might make it easy to download and extract (ex. rust-starter.zip or js-starter.zip).
We could also rely on language-specific templating functionality, but this would likely require ensuring that it exists in the first place for all related languages (i.e. cargo component new, jco new, componetize-py new, etc), or in a shared tool like wit-bindgen which may not be feasible.
- Ngôn ngữ chính
- Rust
- Star
- 137
- Fork
- 88
- Merge trung bình
- 10 giờ 38 phút
- Pull request đã merge (30 ngày)
- 2
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 bytecodealliance/component-docs
-
Độ khó 2/5 Nửa ngày Mức phù hợp với người mới 72/100
-
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 65/100
-
[FEATURE] Add wasi-cli templates Đang mở
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 68/100
bytecodealliance/component-docs#294 · 1 bình luận ·
-
Độ khó 3/5 1-2 ngày Mức phù hợp với người mới 68/100
bytecodealliance/component-docs#376 · 1 bình luận ·
-
Fix Python Tutorial Đang mởbug lang/python
Độ khó 3/5 1-2 ngày Mức phù hợp với người mới 55/100
bytecodealliance/component-docs#348 · 2 bình luận ·
Tất cả issue của bytecodealliance/component-docs
Issue tương tự
-
bug github_actions
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 75/100
registrystack/registry-stack#1393 ·
-
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 75/100
longbridge/gpui-kit#3223 ·
-
bug engine
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 65/100
rocky-data/rocky#2181 ·
-
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 70/100
oasisprotocol/oasis-sdk#2523 ·
-
[indexer] [QA] Add a focused test for the new NonRetryableError / assertSocketAlive() behavior. Đang mởbot:ai-assisted component:indexer QA-roadmap status:untriaged
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 75/100
midnightntwrk/midnight-indexer#1557 ·