Bijdragen — jouw ervaring maakt dit beter¶

Eerst dit¶

Als je hier terechtkwam via een workshop, of gewoon omdat iemand je de map doorstuurde: ik hoop oprecht dat je er iets aan hebt gehad. Niet aan de hele map — dat is niet de bedoeling. Wel aan die ene handleiding voor jouw niveau, aan die ene prompt die eindelijk deed wat je wilde, of aan dat ene inzicht dat je toets al jaren mede het leesniveau maat.

En als het gewerkt heeft: vertel het. Niet uit beleefdheid, maar omdat jouw leercurve de kortste weg is voor de volgende. Iemand die drie weken zoekt om een prompt goed te krijgen voor kleuterobservaties, bespaart tien collega's diezelfde drie weken door één alinea op te schrijven.

Dit is geen afgewerkt product van één iemand. Het is een startpunt dat beter wordt naarmate meer mensen erin schrijven wat ze zelf ondervonden.

Wie mag bijdragen?¶

Iedereen. Echt iedereen.

Leerkrachten van elk niveau, elk vak, elk net
Deelnemers aan een workshop, ook als het je eerste kennismaking met AI was
Leerondersteuners, zorgcoördinatoren, CLB-medewerkers, brugfiguren
Directies en ICT-coördinatoren
Studenten in de lerarenopleiding
Ouders die met hun kind aan de slag gingen
Wie zelf geen leerkracht is maar iets zag dat klopt of niet klopt

Je hoeft geen expert te zijn. Een beginner die opschrijft waar hij vastliep, levert vaak nuttigere informatie dan een gevorderde die alleen zijn beste resultaat toont.

Wat je kunt bijdragen¶

1. Een succeservaring — het waardevolste. Wat probeerde je, wat kwam eruit, en zag je iets bij je leerlingen? Ook klein is goed. Gebruik het sjabloon in 09-ervaringen/.

2. Een mislukking. Minstens even nuttig, en zeldzamer. Wat leek logisch en werkte niet? Waar liep je vast? Wat zou je jezelf van drie maanden geleden zeggen?

3. Een prompt die werkt. Precies zoals jij hem gebruikt, met de context erbij. Naar 06-goed-gebruik/01-promptbibliotheek.md of als ervaring.

4. Een correctie. Een feitelijke fout, verouderde regelgeving, een verwijzing die niet meer klopt, iets wat in jouw net of jouw niveau anders werkt. Deze zijn dringend — laat ze niet liggen.

5. Een ontbrekend niveau, vak of doelgroep. Zit jouw context er niet bij? Schrijf hem, of meld gewoon dat hij ontbreekt.

6. Een verbetering van bestaande tekst. Te lang, te vaag, niet herkenbaar voor jouw praktijk? Zeg het, of herschrijf het.

Hoe je bijdraagt — kies wat bij je past¶

A. Gewoon een bericht sturen (drempelloos)¶

Ken je GitHub niet en wil je dat zo houden? Prima. Stuur je tekst naar info@shiftedmake.com. Een mail met vijf zinnen is een volwaardige bijdrage. Ik zet ze op de juiste plaats.

Wil je liever niet met naam vermeld staan? Zeg het erbij, dan verwerk ik het anoniem.

B. Een issue openen (eenvoudig, wel een account nodig)¶

Op de repo: tabblad Issues → New issue → typen → opslaan. Geen technische kennis nodig, en het is meteen zichtbaar voor anderen die hetzelfde vaststellen.

C. Zelf een bestand toevoegen (voor wie met Git werkt)¶

Fork of maak een branch
Voeg je bestand toe op de juiste plaats — voor ervaringen: 09-ervaringen/
Zet één regel in CHANGELOG.md
Open een pull request met een korte uitleg

Wat een goede bijdrage bruikbaar maakt¶

Vier dingen. Meer niet.

1. Concreet. "AI helpt bij differentiatie" zegt niets. "Ik liet elke leestekst in drie niveaus zetten en gaf alle drie de groepen dezelfde bespreekvragen" zegt alles.

2. Met de context erbij. Welk niveau, welk vak, welke leeftijd, hoe groot de groep. Wat werkt in het vijfde leerjaar, werkt niet in een OKAN-klas — en omgekeerd.

3. Eerlijk over wat je zag. Als je niets kon meten, schrijf dan dat je niets kon meten. Dat is een correct en bruikbaar antwoord. Overtuigen hoeft niet; nauwkeurig zijn wel.

4. Zonder leerlinggegevens. Dit is de enige harde regel. Geen namen, geen klas- of schoolnaam als die herleidbaar is, geen diagnoses, geen citaten uit verslagen, geen foto's van leerlingenwerk. Werk met functionele omschrijvingen — zie 00-start-hier/02-wat-mag-en-wat-niet.md. Wat je hier deelt, is publiek.

Huisstijl van de handleidingen¶

Voeg je een volledige handleiding toe? Hou dan het stramien aan, zodat alles doorzoekbaar blijft:

Voor wie is dit / wat maakt deze context anders
Je eerste 20 minuten — één concrete, uitvoerbare stap
Vijf good practices, elk met een kant-en-klare prompt
Grenzen in deze context
Zo zie je leerwinst — meetbaar, op leerlingniveau
Verder — doorverwijzingen

Verder: Nederlands, Vlaamse onderwijsterminologie, prompts in codeblokken zodat ze te kopiëren zijn, en tutoyeren. De lezer is een collega, geen cursist.

Wat er met je bijdrage gebeurt¶

Ik lees alles en verwerk het meestal binnen enkele weken.
Grote of belangrijke bijdragen komen in CHANGELOG.md, met je naam als je dat wil.
Ervaringen komen in 09-ervaringen/, zo veel mogelijk in je eigen woorden.
Als iets tot een aanpassing van een handleiding leidt, hoor je dat.
Corrigeer ik iets aan je tekst, dan gaat het over lengte, structuur en privacy — niet over jouw oordeel of jouw ervaring.

Ik kan niet beloven dat alles integraal overgenomen wordt. Ik kan wel beloven dat alles gelezen wordt.

En als je twijfelt of het de moeite is¶

Het is de moeite. De bijdragen waar mensen het langst over twijfelen — "dit is toch niets bijzonders", "dit wist iedereen al" — zijn systematisch de nuttigste. Wat voor jou vanzelfsprekend is geworden, is voor iemand anders precies het stuk dat ontbrak.

Bedankt om het door te geven.