TANS & Aventeon: automatiseringsoplossingen in logistiek en transport, ook als het nét even wat complexer wordtEen match made in heaven. Sinds vier jaar werken TANS en Aventeon samen aan automatiseringsoplossingen voor de logistiek- en transportsector. De twee bedrijven vinden elkaar vooral in de innovatieve ideeën die ze delen. Een interview met Frank Kindt, directeur van […]
Goede documentatie is pas waardevol als deze actueel is, gemakkelijk te vinden is en meegroeit met de software. Daarom vernieuwen we zowel de gebruikershandleiding als de release notes van TALIS en IMPACT. Het resultaat: actuelere informatie, betere vindbaarheid en aanzienlijk minder handwerk achter de schermen.
Waarom de oude aanpak aan vervanging toe was
De oude help van TALIS werd samengesteld met een help-authoring tool die veel handwerk vraagt. Voor de release notes gold hetzelfde. Dezelfde wijziging moest regelmatig op meerdere plekken worden doorgevoerd.
Dat zorgde niet alleen voor extra werk, maar bracht ook het risico met zich mee dat informatie op de ene plek wel werd aangepast en op een andere niet. Daardoor was het lastiger om te bepalen welke informatie nog actueel was.
Documentatie die meegroeit met de software
In de nieuwe werkwijze beschrijven we functionaliteit rechtstreeks vanuit de software, ondersteund door AI. Wanneer de software verandert, wordt ook de beschrijving bijgewerkt. De release notes worden bovendien opgebouwd vanuit de wijzigingen die in een versie zijn doorgevoerd.
Hierdoor blijft de documentatie beter aansluiten op de software en ontstaat een consistente bron van informatie voor gebruikers van TALIS en IMPACT.
Daarbij geldt altijd: AI ondersteunt, mensen controleren. AI neemt een groot deel van het schrijfwerk uit handen en zorgt voor een consistente opzet en stijl. Onze collega's beoordelen vervolgens of de informatie correct, volledig en begrijpelijk is voordat deze wordt gepubliceerd.
Overal beschikbaar, met F1 direct bij de hand
De gebruikershandleiding en release notes zijn beschikbaar op de publieke TANS-wiki. Hierdoor zijn ze ook buiten de applicatie toegankelijk, eenvoudig doorzoekbaar en voorzien van koppelingen tussen gerelateerde onderwerpen.
Wijzigingen zijn direct zichtbaar, zonder dat er software of documentatie hoeft te worden geïnstalleerd.
Tegelijk blijft de uitleg dichtbij wanneer je in de applicatie werkt. Vanaf versie 2027.1 opent de gebruikershandleiding direct op het juiste onderwerp wanneer je op F1 drukt in TALIS of IMPACT.
De release notes van TALIS en IMPACT zijn inmiddels beschikbaar op de publieke wiki.
Van de gebruikershandleiding van TALIS staan de eerste menugroepen online, waaronder Opdrachten, CRM, Facturering, WMS en Flextools. De overige onderdelen volgen stapsgewijs. De gebruikershandleiding van IMPACT verschijnt met versie 2027.1.
Merk je iets op dat onduidelijk of onjuist is? Laat het ons weten. Jouw feedback helpt ons de documentatie verder te verbeteren..
