[PR] docs(education): add Apache Training lesson 10 (english-as-a-programming-language) [magpie]

["justinmclean (via GitHub)" <gi...@apache.org>]

justinmclean opened a new pull request, #810:
URL: https://github.com/apache/magpie/pull/810

   ## Summary
   
   - Adds **Lesson 10 — English as a programming language** to the Apache Training module: an LMS-neutral wrapper around the `english-as-code.md` source page, with learning objectives, four exercises, and a gated self-check.
   - Covers the shift from formal-language to natural-language precision, ambiguity as the new class of bug and the four disambiguating moves (define terms, say what "done" looks like, state boundaries, name edge cases), the four code-hygiene rules for skill prose (review, version, test, DRY), and the "words are the program" framing for diagnosing skill symptoms.
   - Adds the Lesson 10 interactive tutor prompt under `ai-tutors/` and links the lesson from the module README map.
   
   
   ## Type of change
   
   - [ ] Skill change (`.claude/skills/<name>/`) — eval fixtures updated below
   - [ ] Tool / bridge contract (`tools/<system>/*.md`)
   - [ ] Python package (`tools/*/` with `pyproject.toml`)
   - [ ] Groovy reference impl
   - [ ] Cross-cutting (RFC, AGENTS.md, sandbox, privacy-LLM)
   - [X] Documentation (`docs/`, `README.md`, `CONTRIBUTING.md`)
   - [ ] Project template (`projects/_template/`)
   - [ ] CI / dev loop (`prek`, workflows, validators)
   - [ ] Other:
   
   ## Test plan
   
   - [X] `prek run --all-files` passes
   - [ ] For Python packages touched: `uv run pytest` / `ruff check` / `mypy` passes
   - [ ] For Groovy bridges touched: command-line invocation tested end-to-end
   - [ ] For skill changes: eval suite passes for the affected skill
         (`PYTHONPATH=tools/skill-evals/src python3 -m skill_evals.runner tools/skill-evals/evals/<skill>/`)
   - [ ] For skill *behaviour* changes: a new or updated eval fixture is included in this PR
         (a regression test for the bug fixed / the behaviour added — see CONTRIBUTING.md)
   - [ ] Other:


-- 
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.

To unsubscribe, e-mail: commits-unsubscribe@magpie.apache.org

For queries about this service, please contact Infrastructure at:
users@infra.apache.org

Re: [PR] docs(education): add Apache Training lesson 10 (english-as-a-programming-language) [magpie]

["potiuk (via GitHub)" <gi...@apache.org>]

potiuk merged PR #810:
URL: https://github.com/apache/magpie/pull/810


-- 
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.

To unsubscribe, e-mail: commits-unsubscribe@magpie.apache.org

For queries about this service, please contact Infrastructure at:
users@infra.apache.org