Add notes about versions

Signed-off-by: Matthew B White <whitemat@uk.ibm.com>

README.md

@@ -4,6 +4,7 @@ The IBM Blockchain Platform provides advanced tooling that allows you to quickly
 
 This Ansible collection, provided as part of the IBM Blockchain Platform, enables you to automate the building of Hyperledger Fabric networks.
 
+*Please Note* the main branch is now set to `2.0.0-beta`, the `release-1.2` branch is available. If you build a local copy of Ansible for production, please work from the `release-1.2` branch.
 ## Documentation
 
 Documentation for this Ansible collection is available here: https://ibm-blockchain.github.io/ansible-collection/

docs/source/index.rst

@@ -25,6 +25,7 @@ This Ansible collection is maintained by the IBM Blockchain Platform development
    :hidden:
 
    installation
+   migrating-v12-v2.rst
 
 .. toctree::
    :maxdepth: 2

docs/source/installation.rst

@@ -133,12 +133,13 @@ Installing from source
 ----------------------
 
 You can use the ``ansible-galaxy`` command to install a collection built from source. To build your own collection, follow these steps:
+This will build the stable `release-1.2` branch for v1.2.; use the `main` branch for the `2.0.0-beta` level
 
 1. Clone the repository:
 
 ::
 
-    git clone https://github.com/IBM-Blockchain/ansible-collection.git
+    git clone --branch release-1.2 https://github.com/IBM-Blockchain/ansible-collection.git
 
 2. Build the collection artifact:
 

docs/source/migrating-v12-v2.rst

@@ -0,0 +1,10 @@
+..
+.. SPDX-License-Identifier: Apache-2.0
+..
+
+Migrating from v1.2 to version 2
+================================
+
+Consistent with a major version upgrade, the following are important changes between v1.2 and v2
+
+- tba