AI Nieuws VandaagWillison verbergt lange AI-teksten achter een korte menselijke intro
Simon Willison klapt de lange beschrijving die Claude Code of Codex bij een codewijziging schrijft in. Bovenaan staat alleen een korte tekst die hij zelf kiest.
Wat heb je eraan: Wie AI-teksten deelt, voorkomt zo dat lezers afhaken, terwijl alle details beschikbaar blijven.
Een pull request, kortweg PR, is een voorstel om de code van een project te wijzigen, met een beschrijving erbij. Simon Willison is een ontwikkelaar die op zijn blog over AI schrijft.
Waarom vindt Willison AI-beschrijvingen te lang?
Willison laat zijn pull requests tegenwoordig vooral door Claude Code of Codex openen. Dat zijn programma's die zelfstandig code schrijven en wijzigen. Voor hem is zo'n voorstel de eenheid van werk: hij bundelt er wijzigingen in en voegt het resultaat samen als alles klaar is.
Die programma's schrijven ook de beschrijving erbij, en dat doen ze volgens hem te goed. De tekst is nauwkeurig en volledig: het probleem, de oplossing en de controles. Maar het is veel om te lezen.
Willison schrijft dat het niet per se rommel is, "maar het leest als rommel". Zijn reactie op een AI-tekst is meteen: "Ik ga dat niet allemaal lezen." Dat geldt zelfs als hij het voorstel zelf liet maken.
Hoe klapt Willison de tekst van Claude Code in?
Hij gebruikt de HTML-onderdelen details en summary. Dat is een stukje opmaak dat een kopregel toont, met een pijltje om de rest uit te klappen. GitHub, het platform waar ontwikkelaars hun code delen, ondersteunt dit in beschrijvingen en reacties.
Bovenaan zet Willison een korte tekst die hij zelf kiest of nakijkt. Soms haalt hij die uit wat de AI al schreef. Daaronder staat de volledige AI-tekst, ingeklapt onder de naam van het model, bijvoorbeeld "Claude Opus 5.5 Medium". Zo is meteen duidelijk wie de lange tekst schreef.
Een voorbeeld is een wijziging in Datasette, zijn programma om gegevens te bekijken. De opener begint zo: bij brede tabellen, zoals een met 46 kolommen, schoof de pagina ver naar rechts en bleef veel ruimte leeg. Soms voegt hij een schermafbeelding toe.
Kun je de aanpak van Willison zelf gebruiken?
Dat kan overal waar GitHub-opmaak werkt. Je zet de lange tekst tussen de tags details en summary, en je zet in summary een korte kop. Wat bovenaan staat, is wat lezers eerst zien.
Willison belooft zijn lezers dat de korte opener zijn eigen oordeel is over wat de moeite waard is. Hij zegt dat zijn voorstellen daardoor minder rommelig aanvoelen, terwijl alle informatie beschikbaar blijft. Dat is zijn ervaring en geen meting.
Het idee werkt ook buiten code, bij elke lange AI-tekst die je doorstuurt. Lees hem zelf, schrijf in een of twee zinnen wat ertoe doet en bewaar de rest als bijlage.
Gemeld door 1 bron: Simon Willison (121 sterren op GitHub)
Lees de bron (naar de bron)Klopt er iets niet?
Onderwerpen: Claude CodeAI-agents
Elke ochtend het AI-nieuws in je mail
Om 07:00 de belangrijkste berichten, in gewone taal. Gratis, en afmelden kan altijd met één klik. Je meldt je aan bij Buttondown, de dienst die de nieuwsbrief voor ons verstuurt.
