More formatting and updates for RSpec 3.

This should allow sections to be linkable and to bring the docs up to date a
bit more.