Skip to content

Wikily

De documentatietool die we voor onszelf bouwden en daarna hebben afgemaakt voor iedereen.

Wikily
Webapp
Software partner
In production
Wikily

Wat er speelde

Wikily begon als intern hulpmiddel. Wij leveren bij elk project documentatie op, en dat is geen bijzaak. Het is de plek waar staat hoe iets werkt, waar een beheerder terecht kan en wat een volgende ontwikkelaar moet weten voordat hij ergens aan begint.

Het schrijven zelf was nooit het probleem. Het opzetten van de plek waar het moest staan, dat was het. Elke keer opnieuw een omgeving inrichten voordat er ook maar één pagina online stond.

Wat er te krijgen was, paste niet op hoe wij werken. Er ging tijd in instellingen en configuratie zitten voordat er iets stond, en daarna moest iemand die omgeving blijven onderhouden. Dat is werk dat niets toevoegt aan wat er in de documentatie komt te staan.

Het gevolg was elke keer hetzelfde. Documentatie werd het onderdeel dat naar achteren schoof, want er was altijd wel iets dat eerder af moest. En dan is het er niet op het moment dat iemand het nodig heeft.

Wat we bouwden

Een platform waarop je in een paar minuten een documentatiesite hebt staan. Je maakt een project aan en je begint te schrijven. Er zit geen inrichting tussen die je eerst moet doorlopen en er is niets dat je vooraf moet kiezen.

Schrijven en beheren gebeuren op dezelfde plek. Je hoeft niet te schakelen tussen de plek waar de tekst vandaan komt en de plek waar hij uiteindelijk staat, en wat je aanpast is meteen zichtbaar.

Zoeken zit er vanaf het begin in. Je vindt terug wat je zoekt door het in te typen, zonder eerst door een menustructuur te klikken die iemand ooit heeft bedacht. Dat gaat pas echt tellen als de documentatie groeit en de inhoudsopgave lang wordt.

Het platform blijft snel als er meer in komt te staan. Snelheid was een uitgangspunt bij het bouwen, want een documentatiesite waar je op moet wachten is er een die niemand meer opent.

En het leest net zo goed op een telefoon als op een groot scherm. Dat klinkt als een detail, tot je ziet hoe vaak documentatie erbij wordt gepakt terwijl iemand met zijn handen ergens anders mee bezig is.

Wat het opleverde

Wikily draait bij ons intern en is uitgegroeid tot een product dat ook voor andere ontwikkelaars te gebruiken is. Wat als hulpmiddel voor onszelf begon, staat er nu als platform.

De documentatie van onze eigen projecten staat op één plek. Klanten kunnen erbij zonder dat wij iets hoeven op te sturen, en wij hoeven niet te zoeken in wie welke versie het laatst heeft rondgestuurd.

Een nieuwe docsite opzetten is een handeling van een paar minuten geworden. Daarmee is de reden weg om het uit te stellen, en dat is precies waarom er nu wel documentatie ligt.

Omdat we het zelf dagelijks gebruiken, lopen wij als eerste tegen de dingen aan die niet kloppen. Wat er in het product verandert komt uit dat gebruik, dus het groeit mee met werk dat we echt doen.

Could this run the same way for you?

Call, or leave your number. You get no account manager but someone who builds these platforms themselves, and who can tell you straight away whether it can be done and roughly what it costs.

Serge Huijsen

Serge Huijsen

+31 88 777 1234

Picks up six, sometimes seven days a week.

Curious what it would be for you?

Leave your number and we call back within a working day.

Your details stay with us: no newsletter, no selling on, and nobody chasing you three times.

Other projects.

A few more platforms we built and still maintain.

Got a question?