diff --git a/.github/ISSUE_TEMPLATE/bug_report.md b/.github/ISSUE_TEMPLATE/bug_report.md new file mode 100644 index 000000000..03520cf1a --- /dev/null +++ b/.github/ISSUE_TEMPLATE/bug_report.md @@ -0,0 +1,31 @@ +--- +name: Bug report +about: Something in a lesson or on the site is wrong +title: "[bug] " +labels: bug +--- + +## Where + +- Phase / lesson: +- File / URL: + +## What's wrong + + + +## Reproduce + +1. +2. +3. + +## Environment + +- OS: +- Python / Node / other runtime version: +- How you ran it (local, Colab, Docker, etc.): + +## Screenshot or logs + + diff --git a/.github/ISSUE_TEMPLATE/new_lesson_proposal.md b/.github/ISSUE_TEMPLATE/new_lesson_proposal.md new file mode 100644 index 000000000..1290b7680 --- /dev/null +++ b/.github/ISSUE_TEMPLATE/new_lesson_proposal.md @@ -0,0 +1,46 @@ +--- +name: New lesson proposal +about: Pitch a lesson before writing it +title: "[lesson] Phase NN · " +labels: new-lesson +--- + +## Lesson + +- Phase: +- Proposed number: +- Working title: +- Type: Build | Learn +- Languages: +- Estimated time: + +## Why it belongs + + + +## Prerequisites + + + +## What the learner ships + + + +- [ ] Prompt +- [ ] Skill +- [ ] Agent +- [ ] MCP server +- [ ] Tool / script + +## Outline + +1. **The Problem** — what pain does this solve? +2. **The Concept** — core mental model, no code yet +3. **Build It** — from-scratch implementation plan +4. **Use It** — which framework / library to show after +5. **Ship It** — the artifact to produce +6. **Exercises** — 3 proposed + +## Open questions + + diff --git a/.github/PULL_REQUEST_TEMPLATE.md b/.github/PULL_REQUEST_TEMPLATE.md new file mode 100644 index 000000000..38a558a69 --- /dev/null +++ b/.github/PULL_REQUEST_TEMPLATE.md @@ -0,0 +1,31 @@ + + +## What this PR does + + + +## Kind of change + +- [ ] New lesson +- [ ] Fix to an existing lesson +- [ ] Translation +- [ ] New output (prompt, skill, agent, MCP server) +- [ ] Docs / website / tooling + +## Checklist + +- [ ] Code runs without errors with the listed dependencies +- [ ] No comments in code files (docs explain, code is self-explanatory) +- [ ] Built from scratch first, then shown with a framework (for new lessons) +- [ ] Lesson folder matches `LESSON_TEMPLATE.md` structure +- [ ] ROADMAP.md row for the lesson is a markdown link (`[Name](phases/...)`), not bare text +- [ ] One lesson per commit (atomic per-lesson rule) +- [ ] Tested locally / code output matches what `docs/en.md` claims + +## Phase / lesson + + + +## Notes for reviewer + +