Document temporary character of references in repolist.rst 79/91379/1
authorKrzysztof Opasiak <k.opasiak@samsung.com>
Tue, 9 Jul 2019 21:31:00 +0000 (23:31 +0200)
committerEric Debeau <eric.debeau@orange.com>
Fri, 12 Jul 2019 15:40:03 +0000 (15:40 +0000)
According to the comment in repolist.rst references there are only
temporary and should be removed when the project is referenced from
more appropriate place. Unfortunately developer may never notice this
comment as writting to this file in documentation is done by echo
command. To improve this situation let's add an explicit mention about
this temporary character of repolist.rst to the documentation.

Issue-ID: DOC-501
Signed-off-by: Krzysztof Opasiak <k.opasiak@samsung.com>
Change-Id: I8d8b5fe03d29b5141d57e1d06220bd6382a52861
(cherry picked from commit 6688fd00ba150d6bd5c4e2f6cb91dd0c88fbf371)

docs/guides/onap-developer/how-to-use-docs/include-documentation.rst

index 6909cce..996d44e 100644 (file)
@@ -51,7 +51,10 @@ login to gerrit or for git clone requests over ssh.
 The next step is to add a directory in the doc project where your
 project will be included as a submodule and at least one reference
 from the doc project to the documentation index in your repository.
-The following sequence will do this over ssh.
+The following sequence will do this over ssh. Please note that the
+reference to your project in *repolist.rst* should be considered
+temporary and removed when you reference it from more appropriate
+place.
 
 .. caution::