Improve accessibility of project/tutorial project templates
まだ誰も着手していません。
評価
- 難易度
- 5/5
- 見積もり時間
- 1週間以上
- 初心者へのやさしさ
- 25/100
- issue の種類
- 機能追加
- 明瞭さ
- 説明が足りない
- 活発さ
- 停滞
- 技術スタック
- javascript, python, rust, wasm
調査の方向性
まず component-docs リポジトリのレイアウトと issue #219 の提案を確認し、次に、ここで説明されている単一のトップレベルリポジトリ、Current-release tarball、言語固有の scaffolding の各オプションを比較します。チュートリアルリソース用の合意されたセットアップパスを 1 つ定義し、ユーザーが入れ子になったサブディレクトリを移動する必要なく、言及されている Rust、JavaScript、Python のワークフローをカバーできることを検証します。
索引モデルが issue の本文から書いたものです。
説明
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.
- 主要言語
- Rust
- スター
- 137
- フォーク
- 88
- 平均マージ
- 10時間 38分
- マージ済み PR（30日）
- 2
コントリビューションガイド
はじめの一歩
- issue を最後まで読み、次にプロジェクトのコントリビューションガイドを読みます。
- 着手することを issue にコメントします — 二人が同じ作業をするのを防げます。
- リポジトリをフォークし、ブランチを切って変更します。
- issue 番号を参照したプルリクエストを送ります。
bytecodealliance/component-docs のほかの issue
-
難易度 2/5 半日 初心者へのやさしさ 72/100
-
難易度 2/5 1〜3時間 初心者へのやさしさ 65/100
-
難易度 2/5 1〜3時間 初心者へのやさしさ 68/100
bytecodealliance/component-docs#294 · コメント 1 件 ·
-
難易度 3/5 1〜2日 初心者へのやさしさ 68/100
bytecodealliance/component-docs#376 · コメント 1 件 ·
-
Fix Python Tutorial オープンbug lang/python
難易度 3/5 1〜2日 初心者へのやさしさ 55/100
bytecodealliance/component-docs#348 · コメント 2 件 ·
bytecodealliance/component-docs の issue をすべて見る
似ている issue
-
難易度 2/5 1〜3時間 初心者へのやさしさ 75/100
TheLarkInn/aipm#2413 ·
-
documentation
難易度 1/5 1時間未満 初心者へのやさしさ 90/100
alexgorbatchev/simple-ptt#15 ·
-
tooling
難易度 2/5 1〜3時間 初心者へのやさしさ 75/100
-
todo:ticket
難易度 2/5 1〜3時間 初心者へのやさしさ 70/100
-
難易度 2/5 1〜3時間 初心者へのやさしさ 75/100
taikoxyz/taiko-mono#22168 · コメント 1 件 ·