docs(academy): OpenSpec introductie tutorial (parts 1 + 2)#38
Open
WilcoLouwerse wants to merge 7 commits into
Open
docs(academy): OpenSpec introductie tutorial (parts 1 + 2)#38WilcoLouwerse wants to merge 7 commits into
WilcoLouwerse wants to merge 7 commits into
Conversation
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
force-pushed
the
tutorial/openspec-introductie
branch
from
59a4b7e to
7ba58d7
Compare
…pec-introductie # Conflicts: # src/css/site.css
…+ misc updates OpenSpec leerlijn (primary work this session): - Tutorial 1: corrected mappenstructuur (openspec/architecture/ restored with app-specific vs company-wide ADR distinction), added visual ASCII pipeline diagram, fixed /opsx-new vs /opsx-ff explanation - Tutorial 2: new Stap 0 for /opsx-explore, reorganized steps 4-6 to follow canonical dependency chain (proposal → specs → design → tasks), /opsx-ff promoted to align with canonical path, replaced /opsx-verify with openspec validate --strict for spec validation, added Stap 10-11 for /opsx-plan-to-issues + /opsx-apply + /opsx-verify + /opsx-archive DeskDesk leerlijn: - Renumbered tutorial 5 → 6 (integrate) to make room for advanced manifest - Updated tutorials 0-4 + i18n/nl translations Other updates: - Hydra tutorial 6 (troubleshooting escalatie) - Claude skills tutorial 1 - WOO tutorials (bestanden uploaden, register opzetten) - Build-an-app tutorial - ConNext landing page (src + i18n) - BlogListPage theme component - package.json + .nvmrc Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
5 tasks
BlogListPage (filter / series-focus improvements): - Add `series` query param to dedicated focus mode: skip module-collapse and the Featured slot when a series is active, sort parts by partNumber ascending so Part 0 → N reads in natural order - Hide the series chip row outside the "Everything" and "Tutorials" views (it was noise on blog/guide/case-study/webinar filters) - Extract "DeskDesk" → "Build a Nextcloud app" series label into a translate() call so the chip can be localized Locale-aware links (works correctly when viewing /nl/academy/*): - BlogListPage empty-state "View everything" link uses useBaseUrl() - BlogPostPage breadcrumb (Academy + content-type filter) and "View all" in Keep learning… footer use useBaseUrl() Without this the breadcrumb on a Dutch post sent you to the English academy index, and the type chip on the breadcrumb went to the EN filtered view. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
…pec-introductie # Conflicts: # src/css/site.css
This was referenced May 21, 2026
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
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.
Scope
Deze PR dekt deel 1 + 2. Vervolgdelen (deel 3 retrofit en optioneel deel 4/5) zijn afgesplitst naar opvolg-issue ConductionNL/.github#95 en komen in een aparte PR.
Test plan
openspecvoorbeelden werken