Make a few tweaks to the docs

Based on @paulboon's feedback.