Documentatie

Twee weken geleden schreef ik over mijn kennisbank opbouwen. Vandaag maakte ik hem slimmer. De aanleiding? Een blogartikel van Martijn Aslander. De aanleiding Martijn Aslander schreef een artikel met de titel “Ik zit op iets bijzonders en ik krijg het niet uitgelegd”. Hij bouwt apps met AI, maar waar hij echt over schrijft is informatieliquiditeit: kennis die niet opgesloten zit in losse bestanden, maar doorzoekbaar en verbonden is op basis van betekenis. ...

Vandaag heb ik opgeruimd. Niet mijn bureau (dat is hopeloos), maar mijn projectenmap. Wat begon als “even die losse bestanden consolideren” werd een complete herstructurering van hoe ik kennis bewaar. De situatie Ik werk aan meerdere projecten tegelijk: een Zweedse taal-app, een gezondheids-tracker, een recepten-app, een statische website. Elk project heeft een LEARNINGS.md waar ik vastleg wat ik leer. Safari bugs, iOS quirks, dat soort dingen. Het probleem? Die kennis zat verstopt. Als ik in project A een Safari-bug oploste, kon ik dat in project B niet meer terugvinden. Ik loste dezelfde problemen opnieuw op. ...