1-hour workshop: Specify supported runtimes and align cross-platform prerequisites

未关闭

#258 创建于 2026年9月14日 1 条评论 0 个 reaction 已指派 0 人在 GitHub 查看

还没有人认领这个 Issue。

评估

难度: 3/5
预计耗时: 1-2 天
新手友好度: 78/100

Issue 类型: 文档
描述清晰度: 描述清楚
活跃度: 活跃
技术栈: bash, node.js, powershell, python
领域: developer-experience, documentation

调研方向

从 app/client/package.json、content/1-hour/README.md 和 content/1-hour/0-setup.md 开始；比较声明的运行时以及 Bash 和 PowerShell 的设置路径。使用文档中记录的每条 shell 路径运行设置，包括 start-app.ps1，并确认前置条件、运行时版本和 Windows 指南与实际可用的内容一致。

由索引模型根据 Issue 内容生成。

描述

priority: P1

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.json declares 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 分钟
30 天内合并 PR: 1

贡献指南

打开贡献指南

从这里开始

先读完整个 Issue，再读项目的贡献指南。
在 Issue 下留言说明你要接手 —— 这能避免两个人做同样的事。
Fork 仓库，在一个分支上完成修改。
提交 Pull Request，并在描述里引用这个 Issue 编号。

github-samples/pets-workshop 的其他 Issue

full-day workshop: Add Azure prerequisites, cost warning, and resource cleanup 未关闭

priority: P0

难度 2/5 1-2 天新手友好度 78/100

github-samples/pets-workshop#268 · 1 条评论 · 2026年9月14日创建
full-day workshop: Add the missing commit step before creating the feature pull request 未关闭

priority: P0

难度 1/5 1-3 小时新手友好度 88/100

github-samples/pets-workshop#267 · 1 条评论 · 2026年9月14日创建
1-hour workshop: Add concrete validation scenarios for the filter feature 未关闭

priority: P1

难度 1/5 1-3 小时新手友好度 92/100

github-samples/pets-workshop#261 · 1 条评论 · 2026年9月14日创建
1-hour workshop: Include the page data owner in the filter exercise context 未关闭

priority: P1

难度 2/5 1-3 小时新手友好度 78/100

github-samples/pets-workshop#257 · 1 条评论 · 2026年9月14日创建
GitHub security workshop: Add security overview, governance, and rollout exercise 未关闭

priority: deferred

难度 4/5 3-5 天新手友好度 45/100

github-samples/pets-workshop#278 · 1 条评论 · 2026年9月14日创建

查看 github-samples/pets-workshop 的全部 Issue

相似的 Issue

validate-structure inspecte challenge/work/.terraform et rend faux les labs qui ont un provider en cache 未关闭

bug

难度 2/5 1-3 小时新手友好度 75/100

stephrobert/dsoxlab#238 · 2026年9月24日创建
Uniform probability densities use the upper bound as an interval width 未关闭

难度 2/5 1-3 小时新手友好度 75/100

nasa/fmdtools#40 · 2026年9月24日创建
_common_folder() treats a single file as the common folder; single-file archives can't be installed (4.2.8) / crash (master) 未关闭

难度 2/5 1-3 小时新手友好度 75/100

sublimehq/package_control#1780 · 2026年9月24日创建
Set 'Sample' input in 'autorun.py' to utilize 'Sample' Tab in eLog 未关闭

难度 2/5 1-3 小时新手友好度 65/100

pcdshub/mfx#309 · 2 条评论 · 2026年9月24日创建
niri config file addition does not respect existing optional include 未关闭

难度 2/5 1-3 小时新手友好度 70/100

nwg-piotr/nwg-displays#145 · 2026年9月24日创建

更多 Python Issue

精选适合新手参与的 GitHub issue 摘要。