Add readme to docs

Now that we are publishing the docs from this repo at
http://specs.openstack.org/openstack/nova-specs/ add the README to set
of published documents.

Also cleanup README's rst formatting.

Change-Id: If8bf22bb025611b09269a5e4c1a3e49008f1e713
Merge "Add readme to docs"