docs: misc. tweaks

closes #2394