Some doc improvements for RC1

Review by @cvogt