贡献 — 加入实验室
构建它 与我们一起。
面向 Web Standards Lab 的精确、Deno 优先的贡献者工作流。
§1 — 环境设置
git clone https://github.com/open-element/openelement.git
cd openelement
deno install
deno task test
deno task devopenElement 核心 CLI、SSG、serverless API、测试、发布与文档站任务都以 Deno 2.9+ 作为默认运行时。Vite 通过 deno run --allow-read --allow-write --allow-env --allow-net --allow-run --allow-sys --allow-ffi --no-prompt npm:vite 运行——主工作流不需要 npm 或 npx。
发布线
- 更新版本号(packages/*/deno.json)
- 更新 changelog
- 运行 deno task test
- 通过 deno task --cwd tools/release pack:dry-run、deno task release:check、deno task --cwd tools/release publish:npm 发布
- 创建 GitHub Release
§2 — 提交 PR 之前
- deno fmt + deno lint 保持干净
- Conventional Commits(feat / fix / docs / refactor / test / chore)
- 本地门禁全绿——推送前先跑 deno task test
- 涉及架构变更?先写 ADR
分层纪律:新增功能之前,先检查能否在更低层解决——L0 HTML、L1 CSS、L2 浏览器 API、L3 Hono/Vite/Lit,最后才是 L4 自定义代码。
§3 — 可以从哪里入手
第三方 WC 语料库
让 Lit / FAST / Stencil 组件跑通我们的 DSD 冒烟管线,并留下证据。
真实 dogfood
在稳定线上构建一个真实应用,把遇到的问题记录下来。这就是当前的试点。
文档真值
运行文档门禁,修掉过期论断,让公开面始终有证据支撑。