API: some doc string nits

- make sure all docs say "URI" not "Uri".
- add a "." at the end of the doc string.

part of blueprint api
Change-Id: I59d8e3f1a35892b0c918697804406edd510f7d46
Docs: layout our docs like the official openstack docs

Model the sections on http://docs.openstack.org/

Have the following sections:
- getting started
- install
- configure and run
- develop applications
- contribute

This will make future integration with the official docs easier and
it makes our docs more familiar to readers of openstack docs.

Change-Id: Ib84cfd4451b0e4e2569f8a3e027104d3457bb92e