Skip to content

docs(education): use concise page names in the learning-progression table#760

Merged
potiuk merged 1 commit into
apache:mainfrom
potiuk:docs/education-progression-names
Jul 5, 2026
Merged

docs(education): use concise page names in the learning-progression table#760
potiuk merged 1 commit into
apache:mainfrom
potiuk:docs/education-progression-names

Conversation

@potiuk

@potiuk potiuk commented Jul 5, 2026

Copy link
Copy Markdown
Member

Summary

  • The learning-progression table in docs/education/README.md linked several pages with long "How to…" phrasings ("How to work with agents", "How to write your first skill", "English as a programming language", …).
  • Switch them to the concise names used elsewhere (nav / site education graph): Working with agents, Choosing models, Your first skill, Agentic & autonomous work, English as code, Contributing back.
  • Link targets and the "What you will learn" descriptions are unchanged — this is a link-text-only change to 6 table cells.

Type of change

  • Documentation (docs/, README.md, CONTRIBUTING.md)

Test plan

  • Rendered the page and eyeballed the table — the six links show the concise names, targets still resolve.
  • prek run --all-files — not run in this environment; change is pure link text (no code, skills, tools, or evals touched).

RFC-AI-0004 compliance

Docs-only, no behavioural surface — none of the HITL / sandbox / privacy items apply.

Linked issues

None.

Notes for reviewers (optional)

After this change the progression link text no longer matches each page's own H1 (e.g. "Working with agents" vs. the page heading "How to work with agents"). That was intentional — the goal is short, scannable labels consistent with the nav and the site's education graph. Happy to instead align the page H1s to these names if you'd prefer link-text == heading.

Generated-by: Claude Code (Opus 4.8)

…able

The learning-progression table linked several pages with long "How to…"
phrasings ("How to work with agents", "How to write your first skill",
"English as a programming language", …). Switch them to the concise names
used elsewhere (nav / site education graph): Working with agents, Choosing
models, Your first skill, Agentic & autonomous work, English as code,
Contributing back. Link targets and the "What you will learn" descriptions
are unchanged.

Generated-by: Claude Code (Opus 4.8)
@potiuk potiuk merged commit b7c588a into apache:main Jul 5, 2026
8 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.

1 participant