Documenteren, wat is dat?

Ik weet niet wat het is, maar in welk projectteam ik ook terecht kom: er wordt of beroerd of helemaal niet gedocumenteerd. Ik heb het mezelf juist met de paplepel ingegoten dat je functies die je schrijft fatsoenlijk hoort te documenteren. Of ik nu in een VB, een .NET, een Java of een Python project bezig was: ik documenteerde mijn functies en classes goed en uitgebreid en had veel aandacht voor het genereren van nette en overzichtelijke documentatie. Want daar zijn hele mooie tools voor beschikbaar. Maar het lijkt erop dat de programmeurs in Nederland het niet zo nauw nemen met documenteren. Of zeg maar gerust totaal geen aandacht hebben voor het documenteren van hun code. En ik snap dat niet. Want alle goede programmeurs zijn gek van open source software. En raadplegen heel erg veel de documentatie van libraries die ze gebruiken. Want goede open source software is “goed” gedocumenteerd. Maar zelf documenteren ho maar. En er is ook altijd die verdraaide druk van een project (want er is geen poen voor) dat als excuus wordt gebruikt: er is geen tijd om te documenteren. Maar dat beïnvloed echt de duurzaamheid van een stuk software heel erg nadelig. En ook de overdraagbaarheid (naar andere ontwikkelaars) heel erg nadelig. Bij een goed stuk software hoort gewoon een goed stuk documentatie. En dat zou in geen enkel project mogen ontbreken. Het bijzondere is dat wanneer je aangeeft dat je een “aparte programmeur” bent, omdat je graag documenteert, dat men daar dan altijd oren naar heeft. “Wat fijn zeg” zegt men dan. Maar om de een of andere reden is er “nooit” aandacht (en tijd) voor in een project…

Stop using buildout

Ik heb de afgelopen jaren meerdere projecten gedaan waarbij buildout wordt ingezet voor het packagen van een project. Maar dat is niet slim. Want in die projecten werd ook steeds gebruik gemaakt van een CI (Continuous Integration) tool zoals Jenkins of Atlassian Bamboo. En die tools verlangen altijd shell scripts om installatie taken uit te voeren op servers. En die tools verzorgen echt op een hele mooie manier een deployment. En bovendien is pip heel erg goed in staat om Python packages te installeren en versies mee te beheren. En hiervoor heb je maar een paar eenvoudige commando’s nodig. En niet allerlei buildout scripts. Buildout maakt een project onnodig complex. En complexiteit moet je zoveel mogelijk proberen te vermijden. Dit lijkt echt een developer dingetje: leuk om complexiteit te introduceren.

Links:

Git workflow: merge policy versus rebase policy

Ik heb de afgelopen paar jaar in verschillende projecten meegewerkt waar Git als versiebeheer systeem wordt gebruikt. En in ieder project was er gezeur over de Git workflow. Over de manier van werken met branches, tags en releases wordt men het steeds wel eens. Maar over de manier van werken met commits niet. Dat is altijd gezeur. Er zijn op hoofdlijnen twee stromingen: merge policy en rebase policy. En de discussie kwam steeds uit op: laten we rebasen. En commits squashen. En dat is dom. Want de tooling die beschikbaar is (Github, Gitlab, Atlassian BitBucket enzovoorts) geeft ons een “merge” knop. Dus je kunt het allemaal op de commandline gaan doen als je wilt gaan rebasen. En bovendien is het “rebase policy” ook nog eens veel gevaarlijker, omdat je je versie geschiedenis van je broncode in je repository aan het tweaken bent. En als je het rebasen fout doet ben je je code gewoon kwijt. En Git is juist bedoeld om “dat” te voorkomen. De argumenten om voor rebasen te kiezen zijn steeds: dan zijn de pull requests beter te lezen, dan is de commit history veel schoner enzovoorts. Maar het heeft gewoon met een manier van werken te maken. Zorg dat je pull request niet teveel code bevat. En niet teveel commits bevat. En als dat wel zo is heb je dus aan een flink stuk code zitten werken, dat kan ook. Een stuk nieuwe functionaliteit dus. En als je dat alleen hebt gedaan dan kon je dat blijkbaar ook in je eentje, dus approve en merge zelf dan ook maar gewoon je pull request… En een extra “merge commit” in de commit history: so big deal…

Links:

Slack versus Gitter versus Meet Franz

Ik heb de afgelopen periode weer in een leuke werkomgeving gewerkt waar de ene helft van de developers communiceerde via Slack en de andere helft van de developers communiceerde via Gitter. Toen ik de vraag stelde hoe dat handiger kon was het antwoord: Meet Franz! Een handig tooltje waarmee je zowel kunt inloggen op Slack als op Gitter. Goed bezig! … dacht ik (not). En het werd nog mooier, want waar Slack en Gitter mooie mobile clients beschikbaar hebben voor op je iPad en voor op je mobiel heeft Meet Franz dat weer niet. Het kwam er dus op neer dat ik zowel in Slack als in Gitter ingelogd was, op mijn mobiel en iPad. Het lijkt mij toch wat effectiever als alle developers gewoon dezelfde communicatietool gebruiken. En het werd nog mooier, want op een team van 20 developers hadden ze wel 60 slack kanalen bedacht en opgezet. Wat dacht je van gewoon 1 algemeen kanaal? Dat moet toch genoeg zijn? En zoek mekaar lekker privé op als je 1 op 1 wilt chatten…

En als je dan mijn persoonlijke voorkeur nog wilt weten: kies voor Slack, want Slack werkt heel erg “slack”!

Links:

Paarden enzo

Ik heb zelf best een poos aan mensport gedaan. Je kunt hierover wat meer lezen op de Mensport pagina. Ik vond op internet een hele leuke instructievideo van IJsbrand Chardon. Mijn zus is zo iemand die altijd met BN’ers in contact staat. Zo kwam ze heel vaak bij Anky van Grunsven over de vloer. En voor mij had ze een proefles geregeld bij IJsbrand Chardon. Alleen voelde ik daar niet zoveel voor, omdat ik mennen zelf echt alleen recreatief wil doen. Maar dit is wel een erg leuk filmpje van IJsbrand:

Ik heb met mijn paard een poos op een pensionstal gestaan waar ook best veel Friese paarden stonden. Dit is een heel leuk filmpje over de geschiedenis en de ontwikkeling van het Friese paard. Als je een paard zoekt dat betrouwbaar is, en rustig, dan is een Fries paard heel erg geschikt, want ze zijn heel koelbloedig. Ik wist niet dat ze bij het ringsteken “trouwringen” steken, dat leerde ik zelf weer door dit filmpje:

En tot slot: in Epe wordt ieder jaar de Eper paardenvierdaagse georganiseerd. Dat is een heel leuk evenement waaraan mensen uit heel het land deelnemen. Er worden een aantal dagen routes gereden door honderden ruiters en menners in een grote colonne. Dat is heel erg gezellig. Ik heb zelf ook een keer meegedaan met paard en wagen:

Smooth Jazz @ RadioTunes

Hou je van smooth jazz? Je kunt bij RadioTunes naar een aantal heel mooie smooth jazz radio kanalen luisteren. Ik ben zelf erg fan van het “Vocal Smooth Jazz” channel. Heb ik vaak in de auto aan staan. Voor een paar euro per maand wordt je abonnee. Dit hoeft niet, maar de geluidskwaliteit wordt dan wel echt beter en je hebt geen last van reclame.

Het is een wens van me om nog een keer het Smooth Jazz festival op Mallorca te bezoeken. Of een keertje mee met de Dave Koz cruise. Daar hangt wel even een wat ander sfeertje dan op het North Sea Jazz festival vind ik zelf. Wie weet komt het er nog eens van. Dit is een leuk filmpje van de Dave Koz cruise van vorig jaar:

(ook even goed zoeken naar Keiko Matsui)

Madeira

Het lijkt me heel leuk om nog een keer het bloemeneiland Madeira te bezoeken. Het eiland heeft een subtropisch klimaat. Het eiland ligt ongeveer 1000 kilometer ten zuidwesten van Portugal. Dus de vliegtijd is helemaal niet lang. ’s Winters regent het er veel, vandaar dat het eiland zo enorm mooi groen en bezaaid met bloemen is. En moet je eens kijken wat voor bijzondere huisjes je er tegen komt…

thumb_Santana-Madeira_800x600shutterstock_276396710-1024x678santana2Madeira-Blumeninsel-Hibiskus-Vulkane-FelsenP1010927madeira-02Madeira 2015 014e093929d67093932ae5ceef26e779de7Bloemeneiland-MadeiraView of Funchal port through the blooming flowers. Madeira20623-Madeira_0023-W1024

De middernachtzon en het noorderlicht

Het lijkt me heel erg mooi om nog eens een keer de middernachtzon in het echt mee te maken. Dat kan heel erg goed op de Lofoten Eilanden van Noorwegen. Noorwegen had ik al een keer gezien, en dat vond ik al heel erg mooi. Maar dit lijkt me nog mooier.

Het noorderlicht kun je op deze eilanden ook ervaren:

Links:

WikiKids

Ik kwam van de week toch zo’n mooi initiatief tegen. Ik werk zelf heel veel met Wikipedia. Er is dus ook een initiatief dat WikiKids heet. Het initiatief is gestart vanuit Nederland en al in meerdere landen actief. Stichting WikiKids wordt gesteund door Stichting Kennisnet, en stichting Kennisnet wordt weer gesubsidieerd door het Ministerie van Onderwijs, Cultuur en Wetenschap. Voor de Nederlandse WikiKids zijn op dit moment 7 moderators uit verschillende sectoren (waaronder onderwijs) en lagen van de bevolking actief (ook jongeren), en dat mogen er meer worden. www.wikikids.nl.