Make documentation improvements

Thanks to @jdeisenberg for the suggestions!