diff --git a/README.md b/README.md
index 4ccf2cf1858a4b0462dd629eb2cf8e01a0d98bf4..1dea0b70d1550b11bcbf38a7f856730a490bc6f9 100644
--- a/README.md
+++ b/README.md
@@ -17,7 +17,8 @@ These diagrams roughly serves as the specifications for adapting ATDB for LDV.
   * workflow: https://support.astron.nl/confluence/display/LDV/WORKFLOW
   * datamodel: https://dbdiagram.io/d/5ffc5fb180d742080a35d560
 
-## Overview Diagrams
+## Overview Diagrams (current implementation)
+These diagrams show the current implementation and are kept up-to-date.
 
 ### Datamodel:
   * https://drive.google.com/file/d/1v5hMBQS0jT8DQJwySVISfRa1zF4o0fCQ/view?usp=sharing  
@@ -29,7 +30,7 @@ These diagrams roughly serves as the specifications for adapting ATDB for LDV.
 
 ![](atdb/docs/ATDB-LDV%20Workflow%20Diagram.png)
   
-### Test Environment on sdc-dev.astron.nl:
+## Test Environment on sdc-dev.astron.nl:
 
 ### main GUI:
   * https://sdc.astron.nl:5554/atdb/
@@ -43,29 +44,32 @@ serializers:
   * tasks: http://sdc.astron.nl:5554/atdb/tasks/
 
 get_size:
+Return the sum the sizes of all tasks with a given list of statusses 
   * https://sdc.astron.nl:5554/atdb/tasks/get_size
   * https://sdc.astron.nl:5554/atdb/tasks/get_size?status__in=staged,processing,processed,validating,validated,ingesting,removing,removed
 
+## Build & Deploy
+
 ### Deployment Diagram:
   * https://drive.google.com/file/d/1_j9Fp505pZTxcmzAEdgftdPkoIFrKfAX/view?usp=sharing
   
 ![](atdb/docs/ATDB-LDV%20-%20Deployment%20Diagram.png)
   
-## CI/CD (semi) automatic deploy in Docker
+### CI/CD (semi) automatic deploy in Docker
 For the `master` branch there is a CI/CD pipeline in place which builds and deploys the backend at https://sdc.astron.nl:5554/atdb/ 
 
 The deploy step requires pushing the 'play' button in the gitlab pipelines section. 
 This is done to not have a mandatory deploy for every minor commmit.
 
-## Manual deploy in Docker (alternative to CI/CD)
+### Manual deploy in Docker (alternative to CI/CD)
 
-### initial
+#### initial
 
     > cd ~/my_docker
     > cd atdb-ldv
     > git clone https://git.astron.nl/astron-sdc/atdb-ldv.git
 
-### update:
+#### update:
 
     > export DOCKER_BUILD_DIR=$HOME/my_docker/atdb-ldv/atdb-ldv/atdb
     > export DOCKER_COMPOSE_DIR=$DOCKER_BUILD_DIR/docker
@@ -75,7 +79,7 @@ This is done to not have a mandatory deploy for every minor commmit.
     > cd $DOCKER_COMPOSE_DIR
     > docker-compose -p atdb up -d
     
-### Database changes and migrations
+#### Database changes and migrations
 When the `models.py` is changed, then the database must be migrated.
 This is the procedure for that.