This change is supposed to improve the documentation that currently
exists, without adding much new content.
Details:
* Reorganized the main page into a common overview section, a
section for users of the driver, and a section for contributors,
and a section with links for quick access.
* Separated between the `README.rst` file and the introductory text
on the main page, because the `README.rst` file stands on its own
when shown on the Github code page, while the introductory text
is part of the larger documentation. As a result, removed the
`doc/source/readme.rst` file.
* Added an empty chapter for the topology to the overview section
of the main page, instead of referencing the readme file.
* Cleaned up headings and file names somewhat.
* Added link targets to any major headings.
* Adapted the contributions page to the project, and added links
for the Git repo and the Gerrit review page.
Change-Id: Id7a9a632984ad8945ca1dd347a7766601030a373
Partial-Bug: 1660689
Signed-off-by: Andreas Maier <maiera@de.ibm.com>
cf932be130