diff --git a/README.md b/README.md
index 6c56c1720aee203538d74753c29295c6c1e84e0d..191c502d4b4809a5aae6c8e43e2e64f124a6b1cc 100644
--- a/README.md
+++ b/README.md
@@ -16,6 +16,8 @@ docker run -v /usr/local/bin:/setup --rm registry.lakedrops.com/docker/l3d/setup
 
 This will install the script `l3d` into the given directory `/usr/local/bin` from where it is executable everywhere on your host (assuming this path being in your search path). If you want that script to be installed elsewhere then provide that alternative path in the install command above. Also, instead of `latest` you can also start with any othe specific version number of this tool. You can find all available version string in the [tag list](https://gitlab.lakedrops.com/docker/l3d/tags) of this project.
 
+NOTE: depending on your system setup it may well be impossible for Docker to mount the example directory `/usr/local/bin` from above. We've seen this happening especially on MacOS. In such cases, please use a different directory and make sure that it's part of the PATH environment variable so that it remains convenient to execute that script from everywhere.
+
 ## Usage
 
 Go to the project root for which you want to use **L3D** and execute the installed script (simply type `l3d` at the command prompt). It will ask you for the PHP version to be used (input `7.0`, `7.1` or `7.2`) and it will download the matching **L3D** image and start a container for you.
@@ -31,13 +33,9 @@ Inside the container you'll find the directory `/drupal` which contains everythi
 | DorgFlow | `dorgflow` | |
 | Drush | `drush` | `d` |
 
-## Update the image
-
-When starting **L3D** with the script this will simply re-use the latest available image in your local docker environment. To force your docker to download the latest version of an image you can use `l3d update` which will check for an updated version of the image and pull that to your host for subsequent commands.
-
 ## Update the start script
 
-Just call `l3d selfupdate` and the start script will be updated from the original repository.
+Just call `l3d selfupdate` and the start script will be updated from the original repository. This will also update all your existing **L3D** images and remove the outdated containers so that they will be recreated the next timne you're going to use them.
 
 ## Working with Git credentials
 
@@ -63,12 +61,10 @@ cd /var/www
 mkdir testproject1
 cd testproject1
 l3d
-wget https://gitlab.lakedrops.com/composer/project/drupal-8/raw/master/.gitignore
-wget https://gitlab.lakedrops.com/composer/project/drupal-8/raw/master/composer.json
-composer create-project --no-interaction
-ahoy d4d up
 ```
 
+You will be presented with a list of options on how to get started and you can simply follow the instructions on screen.
+
 ### Use with an existing project
 
 ```bash