Update notes for submitted changes

* API: some doc string nits
Update notes for submitted changes

* Docs: layout our docs like the official openstack docs