doc tweaks with ~~~ and ```