Skip to content

docs(education): add maintainer-education landing page and index#713

Merged
potiuk merged 1 commit into
apache:mainfrom
justinmclean:education-landing-page
Jul 4, 2026
Merged

docs(education): add maintainer-education landing page and index#713
potiuk merged 1 commit into
apache:mainfrom
justinmclean:education-landing-page

Conversation

@justinmclean

Copy link
Copy Markdown
Member

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

  • 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)
  • Documentation (docs/, README.md, CONTRIBUTING.md)
  • Project template (projects/_template/)
  • CI / dev loop (prek, workflows, validators)
  • Other:

Test plan

  • 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:

Beginner-voice landing page for the maintainer-education stream, plus a
docs/index.md entry point and a MISSION.md pointer. The office-hours
commitment is dropped from MISSION pending PMC agreement; the README keeps
a workshops row (a self-paced lab) and lists pattern-catalogue.md as live
now that it has merged.

Generated-by: Claude Code (Opus 4.8)
@potiuk
potiuk force-pushed the education-landing-page branch from 6a9e2cd to 537599d Compare July 4, 2026 16:53

@potiuk potiuk left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Re-reviewed after the reconciliation restack — now a single commit. Beginner-voice landing page + docs/index.md entry + MISSION pointer. The README table is reconciled: pattern-catalogue.md shown as a live link (it's merged), the workshops.md row restored so the series' lab page stays in scope, and your-first-skill.md / eval-driven-development.md remain "Coming soon" until #715/#716 land. Office-hours commitment stays dropped from MISSION pending PMC — the workshops page is a self-paced lab, not scheduled office hours. lychee clean, no emojis, placeholder-clean, TOC intact. LGTM.

@potiuk
potiuk merged commit 7fd1d33 into apache:main Jul 4, 2026
34 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants