📖 Documentatie: https://testcoders.github.io/hackathon/
De site gaat live zodra GitHub Pages is ingeschakeld onder Settings → Pages → Source: GitHub Actions. Tot die tijd draai je de docs lokaal met
npm run docs:dev.
Documentatiesite met alle onderwerpen voor de TestCoders hackathon. Elk onderwerp is uitgewerkt als MVP volgens één vast template, zodat teams van tevoren weten wat ze bouwen en wanneer het af is.
Gebouwd met VitePress. Alle content is Nederlandstalig.
npm install
npm run docs:devDe site draait daarna op http://localhost:5173/hackathon/.
| Commando | Wat het doet |
|---|---|
npm run docs:dev |
Lokale ontwikkelserver met hot reload |
npm run docs:build |
Productiebuild naar docs/.vitepress/dist |
npm run docs:preview |
Productiebuild lokaal bekijken |
Start hier:
- Introductie / homepage — hoe de hackathon werkt
- Dagprogramma — tijdschema en afspraken voor de dag zelf
- MVP-overzicht — alle onderwerpen per categorie
- MVP-template — het lege template met invulinstructie
- Bijdragen — een onderwerp toevoegen of invullen
Gereedschap voor testers en developers.
- Coding guidelines + AI-skills
- Browser plugin voor locators
- Testdatagenerator
- AI testpipeline / agent tool
Interne tooling en de eigen website.
Zelf bouwen wat je normaal importeert.
AI zonder dat data de organisatie verlaat.
Niet bouwen maar breken.
docs/
.vitepress/config.mts navigatie, sidebar, thema
index.md homepage
dagprogramma.md tijdschema en afspraken voor de hackathondag
template.md leeg MVP-template
bijdragen.md hoe je content toevoegt
mvp/
index.md overzicht van alle onderwerpen, per categorie
break-it.md break-it als één samengevoegd MVP
testing-toolbox/ onderwerpen (geen aparte categoriepagina)
testcoders/
framework/
local-llm/
overig/
.github/workflows/deploy.yml build en publicatie naar GitHub Pages
- Kopieer docs/template.md naar de juiste categoriemap.
- Vul alle zes secties in.
- Voeg de pagina toe aan de sidebar in docs/.vitepress/config.mts en aan docs/mvp/index.md.
Uitgebreide instructies staan in docs/bijdragen.md.
Elke push naar main bouwt en publiceert de site via GitHub Actions naar GitHub Pages: .github/workflows/deploy.yml.
Eenmalig instellen: zet in de repository onder Settings → Pages → Source de bron op GitHub Actions, anders faalt de eerste deploy.
De base in de VitePress-config staat op /hackathon/, passend bij https://testcoders.github.io/hackathon/. Gebruik je een eigen domein, pas dan base aan naar /.