Hoe iText haar knowledge base optimaliseerde dankzij Confluence

Net als hun vorige database bevat de nieuwe iText kennisbank alle technische informatie en documentatie over hun producten. Onze Atlassian experts migreerden deze content van het vorige platform, hun wereldwijde website, naar een nieuwe Confluence-omgeving.

Verbetering van de gebruiksvriendelijkheid

Voor de nieuwe kennisbank hielden we ook rekening met het belang van goede SEO. Dit betekent dat de kennisbank de zoekresultaten van gebruikers zeer nauwkeurig kan rangschikken op relevantie.

Daarnaast kunnen gebruikers niet alleen specifiek zoeken op een bepaald product, maar ook op verschillende releases van dat product, afhankelijk van welk product de klant of bezoeker gebruikt.

Google Analytics is ook geïntegreerd in de kennisbank om SEO positief te beïnvloeden. De zoekbalk toont bijvoorbeeld sneller zoekresultaten aan de gebruikers. Er wordt ook een 'snippet' weergegeven bij elk zoekresultaat, die een korte uitleg geeft over dat specifieke zoekresultaat. Tot slot is het ook mogelijk om op elk moment te filteren op specifieke zoektermen en producten.

Om de gebruikers zoveel mogelijk structuur te bieden, hebben we de kennisbank in drie ruimtes verdeeld. Elke ruimte vertegenwoordigt een product van iText: iText 7, iText DITO en iText 5. Deze drie ruimtes worden samen gepubliceerd in één openbare kennisbank. Op die manier is de kennisbank gestructureerd, maar kunnen gebruikers ook gemakkelijk van het ene product naar het andere overschakelen.

Volledig aangepast en in de huisstijl van iText

Om onze Confluence-oplossing nog beter te laten werken met iText, hebben we twee belangrijke applicaties gebruikt die aan Confluence zijn gekoppeld: Scrollversies en Scroll viewport.

Scrollversies zorgt ervoor dat documentatie in Confluence heel specifiek voor één bepaalde versie van een product geschreven kan worden. Het maakt het ook mogelijk om bepaalde versies in de kennisbank te verbergen of te tonen. Hierdoor kan iText achter de schermen werken aan nieuwe versies van documentatie, terwijl de huidige versie nog steeds beschikbaar is voor gebruikers. Zodra er een nieuwe versie van een product beschikbaar is, kan de documentatie eenvoudig gepubliceerd worden.

Scroll viewport publiceert de documentatie in Confluence. De volledige interne documentatie wordt extern gepubliceerd naar de iText publieke kennisbank. Scroll viewport zorgt ook voor correcte styling van dit gepubliceerde materiaal. Op basis van CSS worden de iText huisstijl, lay-out en lettertypes volledig opgenomen in de kennisbank. Hierdoor sluit het mooi aan bij hun website.

Confluence bewijst eens te meer dat het een uitstekend platform is om kennisbanken te bouwen. Door de extra functionaliteiten zoals versiebeheer en publicatiebibliotheken is het voor de gebruikers eenvoudig om toegang te krijgen tot hun installatiegidsen, voorbeelden en technische documentatie. De zoekbalk is ook continu aanwezig op de homepage, wat betekent dat de kennisbank altijd toegankelijk is in de rest van de website. Hierdoor kunnen gebruikers eenvoudig zoeken via trefwoorden en filteren op technologieën, producten en meer.

De flexibiliteit van Confluence, de juiste applicaties die ermee gekoppeld zijn en de aanpassing aan de huisstijl van iText maakten het mogelijk om een kennisbank op maat te bouwen voor iText.