diff --git a/README.md b/README.md
index 4a6c79926a610911847c6665f7c636bb7fc58962..7232c82dabf6d300b3598d9c08fd53fd1d474031 100644
--- a/README.md
+++ b/README.md
@@ -60,16 +60,16 @@ brew services start code-server
 ### Docker
 
 ```bash
+# This will start a code-server container and expose it at http://127.0.0.1:8080.
+# It will also mount your current directory into the container as `/home/coder/project`
+# and forward your UID/GID so that all file system operations occur as your user outside
+# the container.
 docker run -it -p 127.0.0.1:8080:8080 \
   -v "$PWD:/home/coder/project" \
   -u "$(id -u):$(id -g)" \
   codercom/code-server:latest
 ```
 
-This will start a code-server container and expose it at http://127.0.0.1:8080. It will also mount
-your current directory into the container as `/home/coder/project` and forward your UID/GID so that
-all file system operations occur as your user outside the container.
-
 ### Self contained releases
 
 We publish self contained archives for every release on [github](https://github.com/cdr/code-server/releases).