Documentatie niet aanwezig!

Wachtwoord vergeten, aangepaste code overschreven of iets anders dat er zou moeten zijn maar er niet is. We hebben het allemaal meegemaakt.

Gebruik dit artikel als checklist. Laat je niet imponeren door de technische termen.

Documentatie, Creativiteit kent geen regels

Het duurt niet lang voordat iemand besluit het anders te doen en de andere kant op gaat.

Dus een deel van de website werkt zo en een ander deel zo. Mensen zijn zo. We willen dingen repareren en er zijn veel MacGyvers die echt kunnen improviseren.

Je zit ermee opgescheept als het door iemand anders gerepareerd moet worden.

Zorg ervoor dat degene die verantwoordelijk is voor je website een soort van documentatie heeft en je kunt dit artikel gebruiken als checklist.

Documentatie, Keep it simple stupid (KISS)

Het KISS-principe is welbekend: blijf weg van complexiteit.

Er zijn een paar dingen die altijd gedocumenteerd moeten worden:

  • Beheerderstoegang tot de server
  • Analytics-account
  • API-accounts
  • SQL-databasegegevens
  • Aangepaste CSS
  • Afbeeldingen en video’s

Met uitzondering van de laatste is een fatsoenlijke volledige (systeem)back-up voldoende als je bedreven bent in het uitpakken en vinden van de juiste bestanden. Zo niet, schrijf ze dan op en bewaar een kopie in een cloudopslag. Er komt een dag dat je ze nodig hebt en de ontwikkelaar die de website heeft gemaakt al lang weg is.

Documentatie, geef je Admin-toegangsgegevens door

Je hebt de gebruikersnaam en het wachtwoord voor de hostingservice nodig. Het is niet aan te raden om de websiteontwikkelaar deze te laten houden. Geef liever toegang met een andere account / gebruiker omdat je eigenlijk de sleutel van je auto hebt weggegeven.

Bij problemen met de ontwikkelaar ben je kwetsbaar voor afpersing.

Je hebt toegang nodig tot administratie, DNS en FTP.

Documentatie, saVe Google Analytics-account

Analytics-accounts kunnen worden vertakt. Eén account kan kinderaccounts hebben.

Nogmaals, als je van ontwikkelaar wilt veranderen, kan het een probleem worden om je kostbare gegevens te verplaatsen. Bij voorkeur een eigen account of contract.

Documentatie, je API-account

De meeste moderne websites maken verbinding met andere services met een API-sleutel. Google heeft bijvoorbeeld hun gratis gebruik van Google Maps betaald gemaakt, waardoor een creditcard nodig is om een factuur te ontvangen. Als deze niet beschikbaar is, stopt de service op de website.

Zorg ervoor dat je een eigen account hebt.

Documentatie, voor SQL-databasegegevens

De meeste CMS-systemen kunnen alleen werken met een database. De database is het meest kwetsbare deel van de website, daarom is een goede gebruikersnaam en sterk wachtwoord nodig.

Deze gegevens worden opgeslagen in (leesbare) bestanden op de server, maar nogmaals, als de ontwikkelaar weg is, kun je een probleem hebben. Wijzig bij voorkeur de referenties in de configuratie wanneer u van webmaster verandert.

Documentatie saVe je aangepaste CSS

Alle moderne websites gebruiken CSS (Cascaded Style Sheets) om de website ….. op te maken.

Het mooie van CSS is dat je overrides kunt maken, wat in feite betekent dat een ontwikkelaar wijzigingen in het ontwerp kan aanbrengen in één eenvoudig bestand zonder de code van de website aan te raken. Als je de CSS wijzigingen verliest, is de op maat gemaakte styling ook weg. Bij voorkeur vraag je de ontwikkelaar om child themes en override bestanden te maken en deze te documenteren.

Documentatie saVe afbeeldingen en video's

Dit ziet er misschien vreemd uit omdat je media op de website staat? Dat klopt, maar meestal worden de afbeeldingen om prestatieredenen verkleind of gemanipuleerd.

Als je een fotograaf hebt ingehuurd en de ontwikkelaar heeft geen back-up van de originelen, dan moet je geluk hebben dat er ergens een kopie is! Anders krijg je een leeg frame.

Oh, had ik al gezegd dat je website is gecrasht en dat de verantwoordelijke er niet meer is of niet meer beschikbaar is? Al je waardevolle afbeeldingen zijn weg.

Meer in deze categorie

Inhoud is koning

Inhoud is koning

Het belang van inhoud Als er iets is waar iedereen het over eens is, dan is het wel het belang van inhoud op je website. Je hoeft geen bekroonde schrijver te zijn om inhoud voor je website te maken....

Lees meer