Skip to content

docs(academy): OpenSpec introductie tutorial (parts 1 + 2)#38

Open
WilcoLouwerse wants to merge 4 commits into
developmentfrom
tutorial/openspec-introductie
Open

docs(academy): OpenSpec introductie tutorial (parts 1 + 2)#38
WilcoLouwerse wants to merge 4 commits into
developmentfrom
tutorial/openspec-introductie

Conversation

@WilcoLouwerse
Copy link
Copy Markdown
Contributor

@WilcoLouwerse WilcoLouwerse commented May 12, 2026

Summary

Eerste twee delen van de OpenSpec-leerlijn voor de Conduction Academy: wat is OpenSpec en hoe maak je je eerste change.

Refs ConductionNL/.github#51.

Test plan

  • Lokale Docusaurus build — pagina's worden gerenderd
  • Links naar openspec voorbeelden werken
  • Vervolgdelen (3+) komen in een opvolg-PR

WilcoLouwerse and others added 2 commits May 19, 2026 10:42
Two short Dutch tutorials for conduction.nl/academy that introduce
OpenSpec to new developers and partners, per ConductionNL/.github#51:

- Part 1: "Wat is OpenSpec?" — core concepts (spec, requirement,
  scenario, change), repo layout, when to spec-first.
- Part 2: "Je eerste OpenSpec change" — /opsx-new, spec-delta with
  ADDED requirement + scenario, proposal/design/tasks, /opsx-verify.

Each part has five Pluvo questions and cross-links to the Hydra
leerlijn, the workstation tutorials, and the official OpenSpec site.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
Apply the same closing-quiz treatment as the Hydra leerlijn (PR
preceding this one) to both OpenSpec tutorials: replace the static
"Pluvo-vragen" list with "Test jezelf" sections where each question
sits in a .tutorial-quiz card with click-to-expand Hint and Antwoord
spoilers (Docusaurus <Details> with summary prop).

Adds two CSS blocks to src/css/site.css that come over from the Hydra
branch:
- .tutorial-quiz styling, including overrides for Infima's
  .alert--info colours and Docusaurus' built-in Details chevron, so
  the marker flows inline and the open body has readable contrast.
- A brand-aligned blockquote treatment (cobalt palette, callout look)
  so the existing `> Naamgevingsregel` blockquote in tutorial 2 picks
  up the brand styling instead of Infima's washed-out gray default.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
@WilcoLouwerse WilcoLouwerse force-pushed the tutorial/openspec-introductie branch from 59a4b7e to 7ba58d7 Compare May 19, 2026 08:44
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