improve diagram
add labels to arrows where missing
change naming
cut out quite a lot and write a new caption
format md
add id to heading
put some old, unused content into scrap
shorter code
change comment to paragraph text
proofing
bring note into the clear
change notes to list