diff --git a/docs/README.md b/docs/README.md
index 14317ca5..b8bb7712 100644
--- a/docs/README.md
+++ b/docs/README.md
@@ -1,9 +1,8 @@
-***
-
+---
 description: >-
-Welkom bij de gebruikersdocumentatie voor de OpenCatalogi Nextcloud App. Veel
-succes met het gebruik van de app.
-----------------------------------
+  Welkom bij de gebruikersdocumentatie voor de OpenCatalogi Nextcloud App. Veel
+  succes met het gebruik van de app.
+---
 
 # Welkom
 
@@ -24,4 +23,4 @@ Deze documentatie is bedoeld voor diverse doelgroepen:
 
 Voor meer informatie over OpenCatalogi en onze gemeenschappelijke inspanningen, bezoek onze [documentatie-pagina](https://documentatie.opencatalogi.nl) of de officiële website op [OpenCatalogi.nl](https://opencatalogi.nl).
 
-Veel succes met het gebruik van de app. Voor vragen of bijdragen, neem gerust contact met ons op via <support@conduction.nl>.
+Veel succes met het gebruik van de app. Voor vragen of bijdragen, neem gerust contact met ons op via [support@conduction.nl](mailto:support@conduction.nl).
diff --git a/docs/beheerders/README.md b/docs/beheerders/README.md
index 06bd5a54..41899386 100644
--- a/docs/beheerders/README.md
+++ b/docs/beheerders/README.md
@@ -1,10 +1,9 @@
-***
-
+---
 description: >-
-De rol van een "Beheerder" is gericht op het beheren van de publicaties,
-catalogi en metadata, evenals de autorisatie van gebruikers. De
-verantwoordelijkheden van de beheerder omvatten:
-------------------------------------------------
+  De rol van een "Beheerder" binnen het platform is gericht op het beheren van
+  de publicaties, catalogi en metadata, evenals de autorisatie van gebruikers.
+  De verantwoordelijkheden van de beheerder:
+---
 
 # Beheerders
 
diff --git a/docs/developers/README.md b/docs/developers/README.md
index 4296a157..899c3b7e 100644
--- a/docs/developers/README.md
+++ b/docs/developers/README.md
@@ -1 +1,10 @@
-# developers
+---
+description: >-
+  De rol van een "Developer" binnen het publicatieplatform is voornamelijk
+  gericht om bij te dragen aan de ontwikkeling aan de codebase of om
+  aanpassingen te kunnen testen of demonstreren.
+---
+
+# Developers
+
+In dit hoofdstuk worden de verschillende manieren gegeven om een test- of demo-omgevingen op te starten.&#x20;
diff --git a/docs/gebruikers/README.md b/docs/gebruikers/README.md
index 8544890f..a95535e3 100644
--- a/docs/gebruikers/README.md
+++ b/docs/gebruikers/README.md
@@ -1,10 +1,9 @@
-***
-
+---
 description: >-
-Een "Gebruiker" binnen het Publicatieplatform heeft de primaire taak om
-publicaties te creëren en te bewerken. De rol van de gebruiker omvat de
-volgende verantwoordelijkheden en mogelijkheden:
-------------------------------------------------
+  Een "Gebruiker" binnen het Publicatieplatform heeft de primaire taak om
+  publicaties te creëren en te bewerken. De rol van de gebruiker omvat de
+  volgende verantwoordelijkheden en mogelijkheden:
+---
 
 # Gebruikers
 
diff --git a/docs/gebruikers/dashboard.md b/docs/gebruikers/dashboard.md
index c94f4905..2b06bc44 100644
--- a/docs/gebruikers/dashboard.md
+++ b/docs/gebruikers/dashboard.md
@@ -1,9 +1,8 @@
-***
-
+---
 description: >-
-Deze handleiding gaat ervan uit dat de gebruiker beschikt tot een werkende
-OpenCatalogi-Nextcloud app
---------------------------
+  Deze handleiding gaat ervan uit dat de gebruiker beschikt tot een werkende
+  OpenCatalogi-Nextcloud app
+---
 
 # Dashboard
 
@@ -19,7 +18,7 @@ Op het dashboard van OpenCatalogi vindt u handige informatie die je meteen verde
 2. **Metadata** De verdeling over metadata-types van jouw publicaties
 3. **Status** De verdeling over statustypes van jouw publicaties
 
-![app menu](../assets/oc_dashboard.png)
+![app menu](../assets/oc\_dashboard.png)
 
 ### Sidebar
 
diff --git a/docs/gebruikers/publicaties.md b/docs/gebruikers/publicaties.md
index 87b1a8a1..1fbbc61a 100644
--- a/docs/gebruikers/publicaties.md
+++ b/docs/gebruikers/publicaties.md
@@ -46,6 +46,8 @@ Publicaties hebben vaak bijlagen, zoals een verslag of een besluit. Deze zijn ee
 
 <figure><img src="../.gitbook/assets/bijlage_toevoegen_drie_bolletjes.png" alt=""><figcaption><p>bijlage toevoegen via drie bolletjes</p></figcaption></figure>
 
+ 
+
 <figure><img src="../.gitbook/assets/bijlage_toevoegen_actieknop.png" alt=""><figcaption><p>bijlage toevoegen via de actie-knop</p></figcaption></figure>
 
 </div>