Assorted accessibility (and some consistency) fixes for documentation

i've had a play with getting darker shades of color, but sadly - if using white text - they all start looking rather dull. switching to black text solves the contrast issue, but again misses out on some visual pop. i'd say it could be left as a note, but defaults can remain as they are (controversial i know ;) )