When defining `long_description` in setup.cfg using the `file:`
directive, we need to keep everything on one line. Otherwise, it will
treat the value as a block of literal text.

This updates the changelog and includes a final documentation cleanup
pass.