doc tweaks
remove escapes from mid-word underscores (github flavoured markdown)