Skip to content

docs(oefeningen): trim wordy phrasing in simpler exercises#8

Merged
loek-rijksoverheid merged 2 commits intomainfrom
docs/oefeningen-trim
May 7, 2026
Merged

docs(oefeningen): trim wordy phrasing in simpler exercises#8
loek-rijksoverheid merged 2 commits intomainfrom
docs/oefeningen-trim

Conversation

@ericwout-overheid
Copy link
Copy Markdown
Collaborator

Summary

  • Tightened phrasing in docs/oefeningen/*.md where the topic was small but the text ran long (/clear vs /compact, model/effort/cost, plan mode, --dangerously-skip-permissions, zelf-review, sessie-hervatten, etc.).
  • Format per oefening (Achtergrond / Vergelijk / Probeer zelf / Wat je leert) unchanged; bad/good contrast, links, and all technical substance preserved.
  • Net ~11% fewer words across the three files; heaviest trim on claude-code.md (-16%). Heavier oefeningen (subagents, ralph-loop, spec-driven, pr-review-toolkit) intentionally untouched — the heft is earned there.

Test plan

  • Skim each trimmed oefening and confirm no technical info or link was lost.
  • Verify cross-references still resolve (e.g. zelf-review → ralph-loop, CLAUDE.md → claude-md-improver).
  • Confirm Probeer zelf steps remain executable end-to-end.

🤖 Generated with Claude Code

ericwout-overheid and others added 2 commits May 6, 2026 19:35
Tightened phrasing in oefeningen where the topic is small but the text
ran long. Format (Achtergrond / Vergelijk / Probeer zelf / Wat je leert)
unchanged; technical content, links, and bad/good contrast preserved.
Net: ~11% fewer words across the three files, with the heaviest trim on
claude-code.md (-16%).

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
Address awkward phrasings, anglicisms, and word-order issues flagged
during NL language review. Examples:
- "Wanneer schakelt plan mode iets toe wat je anders mist?" → "voegt ... toe dat ..."
- "herwerk" → "extra werk"
- "AI-assistant" → "AI-assistent" throughout verantwoording.md
- "tight feedback-loop" → "strakke feedback-loop"
- "gewhiteliste lijst" → "vooraf goedgekeurde lijst"
- "het sweet spot" → "de sweet spot"
- "in main" → "in de hoofdsessie"
- restored a few sentence fragments to full sentences where the trim
  made them read crooked

No structural or technical content changes.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
@loek-rijksoverheid loek-rijksoverheid merged commit 8cf74ac into main May 7, 2026
8 checks passed
@loek-rijksoverheid loek-rijksoverheid deleted the docs/oefeningen-trim branch May 7, 2026 06:00
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