docs: Update readme instructions (#108)

* docs: Update readme instructions

* Update readme

* Fix issues

* More fixes

* more fixes

* build: fix precommit checks

* docs: further additions

* docs: update

---------

Co-authored-by: Vincent Burckhardt <vincent.burckhardt@ie.ibm.com>
Co-authored-by: Conall Ó Cofaigh <ocofaigh@ie.ibm.com>

Author: 3 people