Some updates to the doc which would be beneficial to someone new to the
process..
Signed-off-by: Martin Hickey <martin.hickey@ie.ibm.com>