docs(education): add maintainer-education landing page and index#713
Open
justinmclean wants to merge 2 commits into
Open
docs(education): add maintainer-education landing page and index#713justinmclean wants to merge 2 commits into
justinmclean wants to merge 2 commits into
Conversation
Creates docs/education/README.md — the landing page for the maintainer- education stream (MISSION § Maintainer education, PRINCIPLE 18). The page explains what the stream is, who it is for, and includes an index table that starts with only the landing page itself and gains rows as the remaining stream pages land (items 3–6 in the plan). Planned pages are listed as plain text (no file links) so the link check stays clean until each page arrives. Links the page from docs/index.md (Where to go next table) and adds an explicit docs/education/ pointer to MISSION.md so the RFC-AI-0004 back-reference to "MISSION.md for the maintainer-education stream" resolves to the landing page via the established chain. Generated-by: Claude (Opus 4.7)
Rewrite the maintainer-education landing page for a learner audience who may be new to AI and AI terms, and for whom English may not be a first language. Lead with a plain-language welcome, add a 'Words to know' glossary that defines model, agent, prompt, skill, deterministic/probabilistic and eval before they are used, and explain in short sentences why building with agents is different. Simplify the coverage table and status labels (Ready / Coming soon). The planned office-hours (workshops) page is dropped from the table. Also drop office hours from MISSION.md (the 'first scheduled workshops' deliverable and the 'Workshops and pairing sessions' education bullet), since whether to run office hours is a PMC decision. Generated-by: Claude (Opus 4.8)
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Creates docs/education/README.md — the landing page for the maintainer-
education stream (MISSION § Maintainer education, PRINCIPLE 18). The page
explains what the stream is, who it is for, and includes an index table
that starts with only the landing page itself and gains rows as the
remaining stream pages land (items 3–6 in the plan). Planned pages are
listed as plain text (no file links) so the link check stays clean until
each page arrives.
Links the page from docs/index.md (Where to go next table) and adds an
explicit docs/education/ pointer to MISSION.md so the RFC-AI-0004
back-reference to "MISSION.md for the maintainer-education stream"
resolves to the landing page via the established chain.
Generated-by: Claude (Opus 4.7)
Type of change
.claude/skills/<name>/) — eval fixtures updated belowtools/<system>/*.md)tools/*/withpyproject.toml)docs/,README.md,CONTRIBUTING.md)projects/_template/)prek, workflows, validators)Test plan
prek run --all-filespassesuv run pytest/ruff check/mypypasses(
PYTHONPATH=tools/skill-evals/src python3 -m skill_evals.runner tools/skill-evals/evals/<skill>/)(a regression test for the bug fixed / the behaviour added — see CONTRIBUTING.md)