Clarify docs

Author: rickettmwork

Diff for: README.md

@@ -9,6 +9,7 @@ Repository, and then use your Liberty server's installUtility command
 to install the hosted features into your server.
 
 ## Contents
-- [Downloading and building LARS](https://github.com/WASdev/tool.lars/blob/master/doc/BUILDING.md)
-- [Installing, configuring and running LARS](https://github.com/WASdev/tool.lars/blob/master/doc/INSTALL.md)
-- [Using larsClient](https://github.com/WASdev/tool.lars/blob/master/doc/LARSCLIENT.md)
+* [Prerequisites](doc/PREREQS.md)
+* [Downloading, installing, configuring and running LARS](doc/INSTALL.md)
+* [Using larsClient](doc/LARSCLIENT.md)
+* [Building LARS](doc/BUILDING.md)

Diff for: doc/BUILDING.md

@@ -1,14 +1,6 @@
-# Downloading and building LARS
-
-Ensure you have the following prerequisites:
-* [Gradle v4.10.2](https://gradle.org/releases/)
-* [MongoDB server](https://www.mongodb.com/download-center/community) compatible with [Java Driver v3.11](https://docs.mongodb.com/ecosystem/drivers/driver-compatibility-reference/#java-driver-compatibility)
-* [WAS Liberty Profile 19.0.0.9](https://developer.ibm.com/wasdev/downloads/#asset/runtimes-wlp-kernel)
-* Your Liberty runtime must contain the following features which can be installed using `installUtility` as follows: `bin/installUtility install cdi-1.0 servlet-3.0 passwordUtilities-1.0 jaxrs-1.1`
-* A Java 8 JDK
-
-Either download `larsServer.zip` from the [Liberty Repository](https://developer.ibm.com/wasdev/downloads/#asset/tools-Liberty_Asset_Repository_Service) and configure `server/gradle.properties` as mentioned in the second step below or build `larsServer.zip` yourself by doing the following:
+# Building LARS
 
+* Download all the [Prerequisites](PREREQS.md)
 * Clone this repo
 * Rename `server/gradle.properties.template` to `server/gradle.properties` and edit to point to your MongoDB and Liberty installation directories:
 ```libertyRoot=/Users/user/Documents/wlp```
@@ -17,3 +9,5 @@ Either download `larsServer.zip` from the [Liberty Repository](https://developer
 * Look at `test-utils/src/main/resources/config.properties` and check you are happy with the specified test ports
 * Launch Gradle to build the code, run the tests and produce the distribution archives: `gradle build dist`
 * You should now have three files in the `build/distributions` directory: `larsServer.zip`, `larsClient.zip` and `bluemixServer.zip`
+
+Now `larsServer.zip` can be [installed, configured and started](INSTALL.md#install-lars-into-liberty)

Diff for: doc/INSTALL.md

@@ -1,15 +1,26 @@
-# Installing, configuring and running LARS
+# Downloading, installing, configuring and running LARS
+
 LARS is a Java EE application running on top of Liberty and can be
 configured like any other Liberty application. When LARS is installed,
 it creates a new Liberty server called `larsServer`.
 
+## Download or Build larsServer.zip
+
+Either download `larsServer.zip` from the [Liberty Repository](https://developer.ibm.com/wasdev/downloads/#asset/tools-Liberty_Asset_Repository_Service) or build it yourself following the instructions in [Building LARS](BUILDING.md)
+
+Download and install the [Prerequisites](PREREQS.md)
+
+## Install LARS into liberty
+
 Unzip `larsServer.zip` into the `WLP_USER_DIR` (usually `wlp/usr/`) directory of an existing Liberty 19.0.0.9 (or newer) runtime.
 
 Install LARS's pre-requisite features, using
 `installUtility` after extracting the zip:
 `bin/installUtility install larsServer`
 
-To configure LARS, edit the files `wlp/usr/servers/larsServer/server.xml` and `wlp/usr/servers/larsServer/bootstrap.properties`.
+## Configure LARS
+
+Edit the files `wlp/usr/servers/larsServer/server.xml` and `wlp/usr/servers/larsServer/bootstrap.properties`.
 
 For a basic LARS server, you will need to configure the following:
 

Diff for: doc/PREREQS.md

@@ -0,0 +1,10 @@
+## In order to run LARS you need the following prerequisites
+
+* [MongoDB server](https://www.mongodb.com/download-center/community) compatible with [Java Driver v3.11](https://docs.mongodb.com/ecosystem/drivers/driver-compatibility-reference/#java-driver-compatibility)
+* [WAS Liberty Profile 19.0.0.9](https://developer.ibm.com/wasdev/downloads/#asset/runtimes-wlp-kernel) or newer
+* A Java 8 JDK
+
+## To build LARS you will additionally require
+
+* [Gradle v4.10.2](https://gradle.org/releases/)
+* Your Liberty runtime must contain the following features which can be installed using `installUtility` as follows: `bin/installUtility install cdi-1.0 servlet-3.0 passwordUtilities-1.0 jaxrs-1.1`