Switch to extensionless README and LICENSE files Since the README and LICENSE files are going to get included into reStructuredText files for documentation rendering, they don't really need .rst extensions and this keeps them more consistent with the AUTHORS and ChangeLog files generated by PBR.
Reformat README.rst In further preparation for embedding the README.rst in Sphinx rendered documentation, shorten the title, switch the copyright statement from a field to a comment and while here clarify that the YAML version used for configuration data is explicitly YAML 1.1.
Trim readme file In preparation for embedding the README.rst in rendered documentation, remove the final paragraph referring to the included docs and URL to the version published online.
Clean up trailing whitespace in documentation Remove some unsightly trailing whitespace in the readme and coder reference.
Move documentation files for packaging preparation Move doc/coder.txt into doc/source/ where Sphinx will expect it, doc/LICENSE to the top-level directory renamed to LICENSE.rst for clarity on its format, and similarly rename README to README.rst as well.