1-hour workshop: Specify supported runtimes and align cross-platform prerequisites
まだ誰も着手していません。
評価
- 難易度
- 3/5
- 見積もり時間
- 1〜2日
- 初心者へのやさしさ
- 78/100
- issue の種類
- ドキュメント
- 明瞭さ
- 明確に書かれている
- 活発さ
- 活発
- 技術スタック
- bash, node.js, powershell, python
調査の方向性
app/client/package.json、content/1-hour/README.md、content/1-hour/0-setup.md から始め、宣言されているランタイムと Bash および PowerShell のセットアップパスを比較します。start-app.ps1 を含む、ドキュメントに記載された各シェルパスを使ってセットアップを実行し、前提条件、ランタイムバージョン、Windows 向けの案内が実際に機能する内容と一致していることを確認します。
索引モデルが issue の本文から書いたものです。
説明
Problem
content/1-hour/README.md requires only a "recent" Node.js and Python version. The current Astro dependency requires Node.js >=22.12.0, but this requirement is not declared in app/client/package.json or stated in the workshop. The same prerequisite section says a Bash-capable shell is required and tells Windows learners to install WSL or Git Bash, while content/1-hour/0-setup.md provides a native PowerShell startup path.
A learner can satisfy the written prerequisites and still fail during setup, or install an unnecessary shell on Windows.
Suggested change
Declare and document supported runtime versions, and describe Bash and PowerShell as alternative setup paths.
Acceptance criteria
-
app/client/package.jsondeclares the supported Node.js engine. - The one-hour prerequisites state a concrete Node.js minimum or supported LTS release and a tested Python range.
- Native Windows learners are told that PowerShell is sufficient when using
start-app.ps1. - Bash/WSL guidance is limited to the Bash script path.
- Setup is tested using each documented shell path.
- 主要言語
- Python
- スター
- 80
- フォーク
- 161
- 平均マージ
- 31分
- マージ済み PR（30日）
- 1
コントリビューションガイド
はじめの一歩
- issue を最後まで読み、次にプロジェクトのコントリビューションガイドを読みます。
- 着手することを issue にコメントします — 二人が同じ作業をするのを防げます。
- リポジトリをフォークし、ブランチを切って変更します。
- issue 番号を参照したプルリクエストを送ります。
github-samples/pets-workshop のほかの issue
-
priority: P0
難易度 2/5 1〜2日 初心者へのやさしさ 78/100
github-samples/pets-workshop#268 · コメント 1 件 ·
-
priority: P0
難易度 1/5 1〜3時間 初心者へのやさしさ 88/100
github-samples/pets-workshop#267 · コメント 1 件 ·
-
priority: P1
難易度 1/5 1〜3時間 初心者へのやさしさ 92/100
github-samples/pets-workshop#261 · コメント 1 件 ·
-
priority: P1
難易度 2/5 1〜3時間 初心者へのやさしさ 78/100
github-samples/pets-workshop#257 · コメント 1 件 ·
-
priority: deferred
難易度 4/5 3〜5日 初心者へのやさしさ 45/100
github-samples/pets-workshop#278 · コメント 1 件 ·
github-samples/pets-workshop の issue をすべて見る
似ている issue
-
難易度 1/5 1時間未満 初心者へのやさしさ 90/100
-
bug
難易度 2/5 1〜3時間 初心者へのやさしさ 86/100
zostera/django-bootstrap4#894 ·
-
難易度 2/5 1〜3時間 初心者へのやさしさ 78/100
use-agent-os/agent-os#3276 ·
-
難易度 2/5 1〜3時間 初心者へのやさしさ 88/100
zephyrproject-rtos/zephyr#119726 ·
-
area/auth bug comp/agent P3 platform/discord type/security
難易度 2/5 1〜3時間 初心者へのやさしさ 88/100
NousResearch/hermes-agent#117848 ·