Zo maak je een lange tekst inklapbaar op GitHub

Wat heb je nodig?

• Een GitHub-account met een plek om te schrijven, zoals een opmerking bij een issue (een melding of taak in een project) of de beschrijving van een pull request (een voorstel om codewijzigingen door te voeren)
• Een lange tekst die je wilt inklappen

Zo doe je het

1. Open het tekstveld van de opmerking of de beschrijving van de pull request.
2. Schrijf bovenaan een korte intro. Houd die zo kort mogelijk, zodat een lezer meteen snapt waar het om gaat. Een screenshot kan helpen, want een afbeelding legt vaak het snelst uit wat er nieuw is.
3. Typ daaronder op een nieuwe regel <details>. Dit label markeert het stuk tekst dat wordt ingeklapt.
4. Typ op de regel daaronder <summary>, dan een korte kop en daarna </summary>. Simon Willison, de maker van het verhaal, gebruikt hiervoor de naam van het AI-model, zoals "Claude Opus 5.5 Medium".
5. Plak daaronder de lange tekst, bijvoorbeeld de uitgebreide beschrijving die een AI-assistent heeft geschreven.
6. Typ na de lange tekst </details> om het ingeklapte deel af te sluiten.
7. Bekijk het resultaat. GitHub toont dan alleen de intro en de kop met een pijltje, en de rest verschijnt als je op het pijltje klikt.

Waar let je op?

• Zet <summary> binnen <details>, dus eerst <details> en direct daarna <summary>. Willison zegt dat hij de volgorde zelf moeilijk kon onthouden.
• Zet de korte intro buiten het ingeklapte deel. Alleen wat tussen <details> en </details> staat, wordt verborgen.
• Volgens Willison laat je met een korte, door een mens gekozen intro zien wat de moeite van het lezen waard is. De volledige tekst blijft gewoon beschikbaar.

De stappen komen uit de bron hieronder. We hebben ze niet zelf uitgeprobeerd. Knoppen en menu’s veranderen soms: ziet het er bij jou anders uit, kijk dan bij de bron.