diff --git a/docs/start/download.md b/docs/start/download.md
index 7557289..905d144 100644
--- a/docs/start/download.md
+++ b/docs/start/download.md
@@ -6,9 +6,9 @@
 
 ## Contents
 
-* [The Distro](#distro)
-* [A Single Jar](#alljar)
-* [Release Notes](#releasenotes)
+* [The Distro](#distro) (Best for getting started.)
+* [A Single Jar](#alljar) 
+* [Getting Started & Release Notes](#getstart-releasenotes)
 * [Examples](#examples)
 * [Maven](#maven)  
 * [Source Code](#source)
@@ -36,7 +36,7 @@
   and [Cloudsoft]({{ cloudsoft_snapshots_base_url }}io/brooklyn/brooklyn-dist/)
 
 
-Just download your preferred flavour and unpack.
+Read the [Getting Started]({{ site.url }}/use/guide/quickstart/index.html) guide to set up your `brooklyn.properties` and `catalog.xml` files, and then try the [examples](#examples).
 
 {% if site.brooklyn-version contains 'SNAPSHOT' %} 
 **Please note**: You are reading the documentation for a snapshot version of Brooklyn.
@@ -67,11 +67,12 @@
 (but again, check the source and date for snapshot JARs){% endif %}.
 
 
-<a name="releasenotes"></a>
-## Release Notes
+<a name="getstart-releasenotes"></a>
+## Getting Started and Release Notes
 
-Release notes can be found [here]({{ site.url }}/start/release-notes/), or more
-specifically for [0.5.0-M2]({{ site.url }}/start/release-notes/0.5.0-M2.html).
+First time using Brooklyn? Read [Getting Started]({{ site.url }}/use/guide/quickstart/index.html) to set up your `brooklyn.properties` and `catalog.xml` files.
+
+Release notes can be found [here]({{ site.url }}/start/release-notes){% if SNAPSHOT %}{% else %}, and specifically for [{{ site.brooklyn-version }}]({{ site.url }}/start/release-notes/{{ site.brooklyn-version }}.html){% endif %}.
 
 
 <a name="examples"></a>
diff --git a/docs/start/release-notes/0.5.0-M2.md b/docs/start/release-notes/0.5.0-M2.md
index be6984b..72da090 100644
--- a/docs/start/release-notes/0.5.0-M2.md
+++ b/docs/start/release-notes/0.5.0-M2.md
@@ -56,4 +56,11 @@
 	* The minimum change for this to work is to update your references to include the Impl suffixes. However, that will result in deprecation warnings.
 	* The recommended approach is to use the EntitySpec when constructing entities. A good place to start is to look at the updated example applications.
 
-2. Some deprecated code has been deleted. All of this code was commented in 0.4.0 with text such as "will be deleted in 0.5".
\ No newline at end of file
+2. The default username for provisioning with jclouds has changed to use the name of the user executing the Brooklyn process. 
+	* Java's `System.getProperty("user.name")` is used instead of 'root' or 'ubuntu'
+	* Usernames can be overridden in `brooklyn.properties` or using system properties.
+		For example, by entering '`brooklyn.location.named.acmecloud.user=root`' in `brooklyn.properties` or using the command syntax `-Dbrooklyn.location.named.acmecloud.user=root`.
+		
+		'`brooklyn.jclouds.aws-ec2.user=root`' could also be used to apply `user=root` to all aws-ec2 VMs. 
+
+3. Some deprecated code has been deleted. All of this code was commented in 0.4.0 with text such as "will be deleted in 0.5".
\ No newline at end of file