docs markup and styling tweaks

many content improvements