diff --git a/docs/usage/docker.md b/docs/usage/docker.md
index f81765f..438abf1 100644
--- a/docs/usage/docker.md
+++ b/docs/usage/docker.md
@@ -10,6 +10,9 @@ within the root directory of this git repository) or you can replace it by
 ``image: docker.timelimit.io/timelimit-server`` which will use prebuilt docker
 images.
 
+In case of self building the image, don't forget to run ``docker-compose up`` again
+to make docker use the new image.
+
 ## example docker-compose.yml with included database
 
 ```
diff --git a/docs/usage/npm-commands.md b/docs/usage/npm-commands.md
index 3df7a66..a8c87d8 100644
--- a/docs/usage/npm-commands.md
+++ b/docs/usage/npm-commands.md
@@ -4,15 +4,24 @@ This requires that you've installed Node.JS and NPM.
 You need this for the development, but you don't need it
 when deploying using Docker.
 
-## npm start
+## Warning
 
-This runs all pending migrations and starts the server.
+You have to run ``npm install`` and ``npm run build`` and restart the server again
+after running ``git pull``. otherwise you will keep using the old version.
+
+## npm install
+
+This install all dependencies.
 
 ## npm run build
 
 This "compiles" the application.
 
+## npm start
+
+This runs all pending migrations and starts the server.
+
 ## npm run lint:fix
 
-This fixes the causes of lint warnings (where possible).
-
+This fixes the causes of lint warnings (where possible). This is only needed
+during the development.