Fix links and formatting of scripting/variables

this was made in a best effort approach, no proof-reading over the
content was done, but
1. no more broken links are reported by mkdocs
2. at a glance, formatting is looking good

most code examples were updated to follow current hercules standards