doc: De-duplicate readme and license files
authorPaul Beesley <paul.beesley@arm.com>
Mon, 23 Sep 2019 15:40:21 +0000 (15:40 +0000)
committerPaul Beesley <paul.beesley@arm.com>
Tue, 8 Oct 2019 16:36:15 +0000 (16:36 +0000)
commit8cc36aec9122305f3537fbaa369d0c72ed324314
treeacf533f96317e3cfec65f7a700d04c578f796609
parent347609510e30f5cc3f33beaad3cf085e8296b883
doc: De-duplicate readme and license files

The readme.rst and license.rst files in the project root overlap
with the index.rst and license.rst files in the docs/ folder. We
need to use the latter when building the documentation, as Sphinx
requires all included files to be under a common root. However,
the files in the root are currently used by the cgit and Github
viewers.

Using symlinks in Git presents some difficulties so the best
course of action is likely to leave these files but in stub form.

The license.rst file in the root will simply tell the reader to
refer to docs/license.rst.

The readme.rst file will contain a small amount of content that
is derived from the docs/index.rst file, so that the Github main
page will have something valid to show, but it will also contain
a link to the full documentation on ReadTheDocs.

Change-Id: I6dc46f08777e8d7ecb32ca7afc07a28486c9f77a
Signed-off-by: Paul Beesley <paul.beesley@arm.com>
docs/index.rst
license.rst
readme.rst