Merge pull request #590 from jdtoy/0.5.0-M2
Update M2 branch with code for hotfixes to release note & download page.
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
