Clean up

The reStructuredText directives are being given their own line so that
they can be updated more easily as the need arises. This is important
because the notes in the `typed_fields` documentation are being changed
to warnings.