Documentatie on Netsensei

Firefox en grouped tabs

matthias@netsensei.nl (Matthias Vandermaesen) — Mon, 22 Nov 2010 23:04:16 +0000

Herinnert u zich nog hoe ik fulmineerde tegen de gepercipieerde traagheid van Firefox enigste maanden terug? Wel, sinds een tijdje ben ik overgeschakeld op Firefox 4. Is die al uit? Neen, maar je kan die in avant-première al uitproberen via de beta’s. Ondertussen zitten we al aan beta 7. Is de browser dan stabiel genoeg? Het wisselt wat. Toen ik in stapte in het betaprogramma was beta 3 nog maar net uit. In een rotvaart hebben ze een paar nieuwe versies de deur uitgestoempt en ondanks een paar ergernissen gaat het wel in de goede richting. Om nog maar te zwijgen van de interface, die ondanks verschillen tussen beta’s, redelijk stevige hawtness beloofd.

Maar daar wilde ik eigenlijk niet over bloggen.

Grouped tabs dus. Zat ik net in mijn zetel met een tiental tabs open met allerlei documentatie voor mijn werk aan dit project. Straks sluit ik het boeltje en neem ik mijn laptop morgen mee naar kantoor. Daar werk ik weer aan andere projecten waar ik al snel een tiental tabjes voor open heb staan. Het is dus jammer om de ‘staat’ van mijn huidige browserspace verloren te laten gaan. Ik heb geen zin om alle documentatie opnieuw te moeten zoeken. Bookmarken dan maar? Can do. Maar dan ontploft mijn bookmarkbar.

Gelukkig zit er in Firefox 4 een nieuwe feature: grouped tabs. Je kan groepjes van tabs maken en dan switchen tussen die groepen. Ik ben mijn openstaande tabs dus niet kwijt: ze worden op de achtergrond bewaard en morgenavond kan ik ze terug opnieuw oproepen terwijl ik mijn tabjes van de kantoorprojecten kan verstoppen in andere groepjes.

Check it out!

Handy!

Ruby on Rails

matthias@netsensei.nl (Matthias Vandermaesen) — Sun, 23 Nov 2008 11:34:16 +0000

Hold on to your hats, kids! Het heeft wat geduurd maar ik heb er eindelijk eens werk van gemaakt en ik ben dit weekend begonnen met Ruby on Rails te spelen. Tof dinges, ja! Ik heb de obligate Hello World! horde al genomen. Nu eerst wegwijs geraken in de documentatie en de beginselen van Ruby doorgronden.

Back in the day

matthias@netsensei.nl (Matthias Vandermaesen) — Tue, 16 Oct 2007 19:06:10 +0000

Vandaag heb ik mijn tanden wat stuk gebeten op het aan de praat krijgen van twee open source paketten: heretrix en webcurator. Allebei stukjes software om websites te harvesten.

Het eerste pakket lijkt eenvoudig te installeren: gewoon de stappen volgen. Alleen weigert de executable de paswoordfile die we hem voeren uit te lezen omdat de rechten op die file veel te los zijn. U zegt? Normaal duiken er problemen op omdat de permissies op een file veel te streng zijn. Niet zo in dit geval. Omdat we de Windows versie gebruiken even geknoeid om de files ‘alleen lezen’ te maken voor een beperkte user account. Maar zelfs dat weigert dit stukje software aan te nemen. Bizar.

Pakket twee is een typisch geval van cryptische documentatie. Een punt waar ik de pest aan heb is dat documentatie geschreven is volgens het stramien stap 1, 3, 5, 7, 9,… en de gebruiker mag door deductie de lege vakken maar zien in te vullen. Niet echt handig als je opeens ergens vast komt te zitten. Natuurlijk moet je ook niet echt rekenen op een grote gebruikersbasis met veel support.

Brengt mij tot de opmerking van collega W.: vroeger, toen de beesten nog spraken, waren computers iets wat typisch tot het geekdom behoordde. Je kocht er eentje en de software moest je goeddeels zelf schrijven. Dat leidde tot magazines waarin je ganser gepubliceerde listings van grave software (games!) kon vinden die je maar had in te tikken waarna je ervan kon genieten. Volgens collega W. hadden die magazines de gewoonte om ergens enkele lijnen in zo’n listing niet te publiceren zodat het programma enkel bruikbaar was voor de uitverkorenen die voldoende inzicht hadden om de code aan te vullen en te verbeteren waar nodig.

Met mijn ervaringen van vandaag moet ik toegeven dat Open Source in een aantal gevallen toch wel nog de neiging heeft om die weg uit te gaan: zuinige documentatie, ontbrekende bibliotheken en installatieprocedures die je zelf maar moet zien samen te stellen omdat toevallig nét jij niet over dezelfde configuratie als de oorspronkelijke programmeur beschikt.

Frustrerend is dat dan. En dan zeggen dat er een stroom is die denkt dat Open Source op het punt staat door te breken. Ja, voor grote projecten die begrepen hebben dat gebruiksvriendelijkheid bestaat uit goede documentatie en de betere support misschien… mjaja.