* py & md copied across

* png added

* update docu link run

* md reformatting

---------

Co-authored-by: 5ila5 <5ila5@users.noreply.github.com>