diff --git a/neo4j/content.md b/neo4j/content.md
index 6fb3eb33b..26ef97837 100644
--- a/neo4j/content.md
+++ b/neo4j/content.md
@@ -6,11 +6,28 @@ Neo4j is a highly scalable, robust, native graph database. It is used in mission
 
 # How to use this image
 
-## Neo4j 2.3
+## Start an instance of neo4j
 
-Documentation for the Neo4j 2.3 image can be found [here](http://neo4j.com/developer/docker-2.x/).
+You can start a Neo4j container like this:
 
-You can start a Neo4j 2.3 container like this:
+```console
+docker run \
+    --publish=7474:7474 --publish=7687:7687 \
+    --volume=$HOME/neo4j/data:/data \
+    neo4j
+```
+
+which allows you to access neo4j through your browser at [http://localhost:7474](http://localhost:7474).
+
+This binds two ports (`7474` and `7687`) for HTTP and Bolt access to the Neo4j API. A volume is bound to `/data` to allow the database to be persisted outside the container.
+
+By default, this requires you to login with `neo4j/neo4j` and change the password. You can, for development purposes, disable authentication by passing `--env=NEO4J_AUTH=none` to docker run.
+
+## Note on version 2.3
+
+Neo4j 3.0 introduced several major user-facing changes, primarily the new binary Bolt protocol. This is not available in 2.3 and as such, there is no need to expose the `7687` port. Due to changes made to the structure of configuration files, several environment variables used to configure the image has changed as well. Please see the [2.x specific section in the manual](http://neo4j.com/developer/docker-2.x/) for further details.
+
+You can start an instance of Neo4j 2.3 like this:
 
 ```console
 docker run \
@@ -19,15 +36,6 @@ docker run \
     neo4j:2.3
 ```
 
-## Neo4j 3.0
+# Documentation
 
-Documentation for the Neo4j 3.0 image can be found [here](http://neo4j.com/developer/docker-3.x/).
-
-You can start a Neo4j 3.0 container like this:
-
-```console
-docker run \
-    --publish=7474:7474 --publish=7687:7687 \
-    --volume=$HOME/neo4j/data:/data \
-    neo4j:3.0
-```
+For more examples and complete documentation please go [here for 2.x](http://neo4j.com/developer/docker-2.x/) and [here for 3.x](http://neo4j.com/developer/docker-3.x/).
diff --git a/neo4j/logo.png b/neo4j/logo.png
index 6e8565c4b..1d4b8f789 100644
Binary files a/neo4j/logo.png and b/neo4j/logo.png differ
diff --git a/neo4j/user-feedback.md b/neo4j/user-feedback.md
index 396f4dc75..51202b7fd 100644
--- a/neo4j/user-feedback.md
+++ b/neo4j/user-feedback.md
@@ -1,12 +1,8 @@
-## Documentation
-
-Documentation for this image is stored in the [`%%REPO%%/` directory](https://github.com/docker-library/docs/tree/master/%%REPO%%) of the [`docker-library/docs` GitHub repo](https://github.com/docker-library/docs). Be sure to familiarize yourself with the [repository's `README.md` file](https://github.com/docker-library/docs/blob/master/README.md) before attempting a pull request.
-
 ## Issues
 
-If you have any problems with or questions about this image, please contact us through a [GitHub issue](%%GITHUB-REPO%%/issues).
+If you have any problems with or questions about this image, please contact us through a [GitHub issue](https://github.com/neo4j/docker-neo4j/issues).
 
-For general Neo4j questions, please ask on [StackOverflow](http://stackoverflow.com/).
+For general Neo4j questions, please ask on [StackOverflow](http://stackoverflow.com/questions/tagged/neo4j).
 
 ## Contributing