Updating docs for failover project example

#214 Added docs about role ordering


Slimming down README

Author: rjrudin

README.md

@@ -46,9 +46,3 @@ how different resources can be configured.
 
 Finally, if you run into trouble, you can either submit an issue to this project or try asking a question 
 [on stackoverflow with marklogic as a tag](http://stackoverflow.com/questions/tagged/marklogic).
-
-Can I use ml-gradle with Roxy?
-=========
-You bet! Starting with version 2.2.0, you can use "gradle mlWatch" to automatically load new/modified modules into the 
-modules database of your Roxy application, and ml-gradle will substitute tokens based on Roxy properties as well. 
-See [Loading modules in a Roxy project](https://github.com/rjrudin/ml-gradle/wiki/Loading-modules-on-a-Roxy-project) for more information.

examples/failover-project/README.md

@@ -1,6 +1,9 @@
 This project shows an example of configuring replica forests for the out-of-the-box databases that are typically worth 
-enabling failover.
+enabling failover. See https://github.com/marklogic-community/ml-gradle/wiki/Property-reference for more properties
+for configuring the replica forests that are created.
 
 Note that you'll need to run this against a cluster with at least two nodes (failover requires three nodes, but you
 only need two nodes to see how ml-gradle will create replica forests).
- 
+
+For complete control of primary and replica forests, check out 
+the [custom forests and replicas](../custom-forests-and-replicas-project) project.

examples/failover-project/gradle.properties

@@ -4,9 +4,13 @@ mlRestPort=8013
 mlUsername=admin
 mlPassword=admin
 
-# The following configuration property lets you easily define how many replicas you want of the forests
-# for each database. For more precise control over forests and replicas, look into DeployCustomForestsCommand
-# and DeployCustomForestsTask.
-#mlDatabaseNamesAndReplicaCounts=Security,2,Schemas,1,Meters,1,App-Services,1
+# mlDatabaseNamesAndReplicaCounts lets you easily configure the number of replica forests you want for each primary
+# forest attached to a given database.
+
+# This example shows configuring multiple default databases with replicas.
+# mlDatabaseNamesAndReplicaCounts=Security,2,Schemas,1,Meters,1,App-Services,1
+
+# This example shows configuring the database created by this project with replicas. You can of course configure the
+# number of primary forests you want for the content database too.
 mlContentForestsPerHost=1
-mlDatabaseNamesAndReplicaCounts=failover-example-content,1
+mlDatabaseNamesAndReplicaCounts=failover-example-content,1

examples/role-project/README.md

@@ -1,2 +1,8 @@
 This project shows how to create a role that refers to itself. See the
 src/main/ml-config/security/roles directory for more information. 
+
+As of version 2.9.0, you don't need to do anything special now. ml-gradle will detect that a role refers to itself, 
+and it will deploy the role twice - once without its role dependencies, and again with its role dependencies. 
+
+In version 2.9.0, ml-gradle will also figure out what order to deploy roles in - no need to order them yourself via
+their filenames.