Add lightweight comments to conf.py and update docs readme (GH-126100)

* Update contributing contact info in readme

* Add lightweight comments to improve docs workflow understanding

* Apply code review suggestions from @hugovk

Co-authored-by: Hugo van Kemenade <[email protected]>

* Add code review suggestion from @AA-Turner

Co-authored-by: Adam Turner <[email protected]>

* Update Doc/conf.py

Co-authored-by: Adam Turner <[email protected]>

* Update Doc/conf.py

Co-authored-by: Adam Turner <[email protected]>

* Update Doc/conf.py

Co-authored-by: Adam Turner <[email protected]>

---------

Co-authored-by: Hugo van Kemenade <[email protected]>
Co-authored-by: Adam Turner <[email protected]>