v1.2 update for README.md

Updates to README documentation guidelines, based on v1.2 BioCommons work.
Informed by Falcon use case development with Pawsey Supercomputing Centre, including @marcodelapierre @audreystott

Author: supernord

README.md

@@ -1,14 +1,37 @@
-Australian BioCommons Documentation Guidelines
+[tool / workflow name]
 ==============
+Australian BioCommons Documentation Guidelines
+
+```
+###################################################################################
+### Delete this section when the first version of the documentation is complete ###
+###################################################################################
+
+You can make use of this template repository as a base template for a new GitHub repository.
+
+General information about the guidelines
+
+- This **template** repository contains a set of guidelines for documenting bioinformatics tools and workflows. 
+- The initial version uploaded to GitHub was informed by current documentation practices and structures used in the GitHub community.
+- These guidelines will be further developed as needed to meet the requirements of the Australian BioCommons community.
+```
+
+---
+
+# General recommendations for using [tool / workflow name]
+
+```
+Recommendations on using the workflow: for example, based on data set size, infrastructure suitability.
+```
+
+---
 
-This repository contains a set of guidelines for bioinformatics tools and workflows. 
+# Resources available here
 
-The initial version uploaded to GitHub was informed by current documentation practices and structures used in the GitHub community.
+This repository contains structured documentation for [workflow name], including links to existing repositories and community resources, as well as a description of the optimisations achieved on the following compute systems:
 
-These guidelines will be further developed as needed to meet the requirements of the Australian BioCommons community.
+- [system name](infrastructure_optimisation.md)
+- ...
 
-See the following links to access the guideline templates:
+---
 
-1. [tools](docs/tools.md)
-2. [workflows](docs/workflows.md)
-3. [infrastructure optimisation](docs/infrastructure_optimisation.md)