Vandaag was het zo ver, de 1000e deploy op het MultiSafepay Documentatie Center. Dit artikel gaat over waarom wij hier trots op zijn, waar afgelopen jaar de uitdagingen zaten en de toekomst van ons Documentatie Center.
Snelle innovaties & goed documenteren = uitdaging
In november 2018 besloten drie medewerkers uit ons Integration Team: Onze documentatie moet beter.
MultiSafepay.com was tot op heden de voornaamste bron van kennis voor onze partners en merchants. Het grote probleem hier was echter dat door de constante, snelle ontwikkelingen in de markt, en onze content, het bijzonder lastig was om de informatie up-to-date te houden.
Tien jaar geleden hadden wij slechts enkele ecommerce plugins, vandaag de dag hebben wij maar liefst 30+ betaalmethodes en 50+ integraties in beheer! Het bijhouden van deze informatie bleek in de praktijk logischerwijs een grote uitdaging. Het gevolg hiervan?
Incorrecte of verouderde informatie op de website
Het is algemeen bekend dat techneuten in codetaal communiceren, een taal die merchants niet altijd spreken. Met constant ontwikkelende content zoals deze, werd al snel duidelijk dat het up-to-date houden van deze content op de website geen gemakkelijke opgave was. Dit was des te meer het geval wanneer deze content niet door de product specialisten zelf geschreven of geüpdatet werd.
Met het oog op de toekomst werd het duidelijk wat voor ons prioriteit nummer één was: Kwaliteit.
Alle content over onze producten moest correct zijn. De oplossing hiervoor?
Een vier ogen check. Alle content wordt door mininaal twee medewerkers bekeken voordat het online komt.
De gekozen techniek
Om een uitgebreid documentatie systeem te ontwikkelen zijn er meerdere mogelijkheden. Wij besloten te kiezen voor een statische webpagina deployer vanwege de veiligheid, snelheid en mogelijkheid om volledig via GIT te werken.
Na het vergelijken van een aantal mogelijkheden kozen wij voor Hugo.
De developers waren al bekend met GIT, de product specialisten hebben het geleerd. Zodra een aanpassing is goedgekeurd gaat deze via een pull request naar de master branch. Vanuit hier hebben wij een deploy tool die het op de webserver zet.
21 Januari 2019 - Documentatie Center 1.0
Op maandag 21 januari 2019 was het zo ver, de eerste versie van ons Documentatie Center ging live. Tijdens de ontwikkeling hebben wij altijd onze doelstelling in gedachten gehouden:
- Het up-to-date en correct houden van alle online informatie.
Het doel van ons Documentatie Center was het creëren van een database van kennis. De gebruikerservaring stond op de eerste plek, dat hield in dat wij deze content op een andere manier konden maken dan normale website content. Wij hoefden bijvoorbeeld geen aanpassingen aan de content te doen t.b.v. SEO doeleinden. Daarnaast konden wij sturen op het opnemen van direct contact, mits er onduidelijkheden waren.
Na de launch merkten wij meteen dat onze tickets aanzienlijk sneller afgehandeld werden. De antwoorden op simpele vragen vonden merchants zelf online, dat gaf ons de tijd om onze merchants écht goed te helpen met complexere vraagstukken.
Documentatie Center 2.0
In januari hebben wij Documentatie Center 2.0 live gezet. Het doel was de UX verbeteren en mobiel. De broncode is tevens openbaar gezet waardoor iedereen een voorstel kan doen om de content te verbeteren.
De toekomst van Documentatie Center 3.0
Wij hebben gemerkt dat het toevoegen van content nooit stopt. Op basis van deze veranderingen, innovaties en input van merchants of collega’s passen wij de informatie elke dag aan.
In Documentatie Center 3.0 willen wij de API voorbeelden dynamischer maken en overstappen op een completere HTML deployer.
Onze deur staat open voor een MBO of HBO student om dit op te pakken. Lijkt het jou leuk deze opdracht uit te voeren - als werknemer of stage -?
Wil jij deze uitdaging aangaan, of heb jij interesse om ons integratie team te versterken?