Improve markdown guidelines wording

Amongst the changes here is that we do not need to have the hex or html
code (numbers) for open and close parentheses (in links) as there are
names. '(' is & followed by lpar; and the ')' is the same but 'rpar;'
instead. This makes it easier to remember and type and it generates the
same html as well (they are all valid). Now the markdown files are
consistent in this (in some cases hex was used and in others the html
code).

Although many markdown files were updated no html files needed to be
updated as it generates the same html. Even so I ran the appropriate
rules to do so just to verify this.

2018/yang/README.md

@@ -32,7 +32,7 @@ this program left and recompiling will reveal other tools including a right rota
 and a shift program.
 
 Strange things happen [when the world is upside
-down](https://en.wikipedia.org/wiki/Wacky_Wednesday_(book))! It is entirely possible
+down](https://en.wikipedia.org/wiki/Wacky_Wednesday_(book))! It is entirely possible
 that this remark is completely misleading.
 
 What exactly does the shift program do?