Van handleiding schrijven naar zelf beheren: e-BO Enterprises leert XML DITA met DocWriter
09/03/2026 - 09:01
e-BO Enterprises ontwikkelde Offshare, een softwareplatform voor het beheer van offshore windmolenparken. Complex? Absoluut. Alle productkennis zat bij de medewerkers. Voornamelijk in hun hoofd, en nog niet op papier. Dus zocht e-BO naar een partner die hen kon helpen om hun productkennis om te zetten in professionele documentatie. Bij DocWriter vonden ze meer dan dat: niet alleen een technisch schrijver die hun basishandleiding schreef, maar ook een expert die hun team wegwijs maakte in XML DITA. Joris Wallaert, Business Consultant bij e-BO Enterprises, vertelt over de samenwerking en de opleiding die hen volledig zelfredzaam maakte.
Offshare is geen eenvoudig product. Het platform verzamelt data van sensoren, weerstations, turbines en andere bronnen om windmolenparken efficiënt te beheren. Voor operators, technici en managers die met al deze data werken, is het cruciaal om snel de juiste informatie te vinden. Alleen zo kunnen ze doordachte beslissingen maken over onderhoud, energieproductie en planning van de windmolens. Maar er ontbrak één essentieel element: een gebruiksvriendelijke handleiding.
"Er was weinig documentatie", vertelt Joris. "Of toch niets dat klaar was om naar klanten te sturen. En met een snel evoluerend product was dat niet langer houdbaar."
e-BO Enterprises ging op zoek naar een externe partner voor het schrijven van een basishandleiding. Het doel? Klanten meer duidelijkheid geven over alle functies en instellingen, rechtstreeks vanuit de software. En zo kwamen ze bij DocWriter terecht.
DocWriter schreef een sterke basis
DocWriter startte met het schrijven van een basishandleiding in XML DITA, via de tool Oxygen XML Author. "Ze hebben echt de moeite gedaan om Offshare te begrijpen", herinnert Joris zich. "DocWriter testte de software, stelde vragen en zorgde ervoor dat de handleiding niet alleen technisch correct was, maar ook logisch opgebouwd."
Het resultaat? Een handleiding die geïntegreerd zit in het product zelf, met een contextgevoelige zoekbalk. Geen losse pdf die gebruikers moeten downloaden. "Gebruikers kunnen meteen vanuit de software opzoeken hoe iets werkt", legt Joris uit. "Dat maakt het veel toegankelijker."
"We waren tevreden over het resultaat, maar wilden niet afhankelijk zijn van een externe partner voor elke kleine update", gaat Joris verder. "Ons product evolueert constant: nieuwe functionaliteiten, aangepaste workflows ... We hadden nood aan flexibiliteit." Daarom stelde DocWriter voor om het e-BO-team te leren werken met XML DITA.
De kickstart die ze nodig hadden
De opleiding vond plaats op het kantoor van e-BO in Ieper. In één dag legde Stefaan, zaakvoerder en technisch schrijver bij DocWriter, de basis uit van gestructureerd schrijven met XML DITA. "Het was geen droge theorie", benadrukt Joris. "Stefaan zorgde voor een goede mix tussen structuur uitleggen en hands-on werken in Oxygen XML Author."
De focus lag op de fundamenten: hoe bouw je een logische handleiding op met concepten en taken? Hoe zorg je voor consistentie en herbruikbaarheid? Hoe navigeer je door Oxygen XML Author en maak je optimaal gebruik van de mogelijkheden?
"Je zou zoiets ook via YouTube kunnen leren", geeft Joris eerlijk toe. "Maar zo’n opleiding met iemand die het product al kent én expertise heeft in technisch schrijven, dat maakt het verschil. Je wordt meteen in de juiste richting gezet. Het was een goede kickstart."
Na de opleiding voelde Joris zich klaar om zelfstandig aan de slag te gaan. En dat was ook nodig, want de handleiding zou alleen maar groeien.
De handleiding groeit mee
Vandaag werkt Joris dagelijks in Oxygen XML Author. De handleiding bestaat nu uit ongeveer 280 pagina's, en dat is nog maar het begin. "We voegen constant nieuwe functionaliteiten toe", vertelt hij. "Elke keer als we een nieuwe functionaliteit uitrollen, update ik de documentatie. Dat gaat heel vlot."
Joris is de handleiding nu ook aan het uitdiepen voor bepaalde profielen. “Ik bouw voort op de basis die er al ligt en voeg telkens nieuwe modules toe. Afhankelijk van je profiel krijg je meer of minder informatie te zien.”
Een ander voordeel van XML DITA? De meertalige uitrol. "Veel tekst wordt automatisch vertaald via UI-tabellen. Omdat de termen al in het product zitten, kunnen we ze automatisch overnemen. Dat bespaart tijd én zorgt ervoor dat vertalingen perfect aansluiten bij het besturingssysteem."
Waarom zelf aan de slag met XML DITA?
Voor e-BO was de keuze om zelf te leren schrijven in XML DITA vanzelfsprekend: "Als je product zo snel evolueert als het onze, is het niet haalbaar om telkens een externe partner in te schakelen. Dan moet je die expertise intern hebben."
Het mooie aan de aanpak van DocWriter? “Ze combineren beide werelden: ze kunnen zelf schrijven, maar ook kennisoverdracht bieden. Je kiest zelf hoe ver je wil gaan", besluit Joris. "Wij wilden volledige controle en flexibiliteit. En dankzij de opleiding hebben we dat nu."
Wil jij ook gestructureerd leren schrijven met XML DITA? Ontdek onze opleiding "Gestructureerd schrijven met XML DITA" of contacteer ons voor een inhouse opleiding op maat.