summaryrefslogtreecommitdiffstats
path: root/docs/guides
diff options
context:
space:
mode:
authorAndrea Visnyei <andrea.visnyei@nokia.com>2020-05-29 12:48:12 +0200
committerEric Debeau <eric.debeau@orange.com>2020-06-15 18:22:14 +0000
commit27747c12e52411f8d63b449e5e0c1351677364bd (patch)
treedfd64869620833a55e2b676e4ac8714d7ff34f96 /docs/guides
parent76ee143d8134c920e862630a082b76bfc54e6bc9 (diff)
[DOC] Editorial changes in Documentation Guide
End to end view moved to Setting up from Introduction. Steps numbered in Setting up and Setting up project repositories title fixed. Issue-ID: DOC-623 Issue-ID: DOC-624 Change-Id: I36fa54c2a86e98f220a80391b91bd1408890a61a Signed-off-by: Andrea Visnyei <andrea.visnyei@nokia.com> (cherry picked from commit 8f678198c7c5eec7f90b84b8ca4843ccf77ba791)
Diffstat (limited to 'docs/guides')
-rw-r--r--docs/guides/onap-developer/how-to-use-docs/documentation-guide.rst13
-rw-r--r--docs/guides/onap-developer/how-to-use-docs/include-documentation.rst20
2 files changed, 15 insertions, 18 deletions
diff --git a/docs/guides/onap-developer/how-to-use-docs/documentation-guide.rst b/docs/guides/onap-developer/how-to-use-docs/documentation-guide.rst
index ff4508090..70e98ad93 100644
--- a/docs/guides/onap-developer/how-to-use-docs/documentation-guide.rst
+++ b/docs/guides/onap-developer/how-to-use-docs/documentation-guide.rst
@@ -17,19 +17,6 @@ Much of the content in this document is derived from similar
documentation processes used in other Linux Foundation
Projects including OPNFV and Open Daylight.
-
-End to End View
----------------
-ONAP documentation is stored in git repositories, changes are managed
-with gerrit reviews, and published documents generated when there is a
-change in any source used to build the documentation.
-
-Authors create source for documents in reStructured Text (RST) that is
-rendered to HTML and published on Readthedocs.io.
-The developer Wiki or other web sites can reference these rendered
-documents directly allowing projects to easily maintain current release
-documentation.
-
Why reStructuredText/Sphinx?
~~~~~~~~~~~~~~~~~~~~~~~~~~~~
diff --git a/docs/guides/onap-developer/how-to-use-docs/include-documentation.rst b/docs/guides/onap-developer/how-to-use-docs/include-documentation.rst
index 8fc6595b6..c59e956a1 100644
--- a/docs/guides/onap-developer/how-to-use-docs/include-documentation.rst
+++ b/docs/guides/onap-developer/how-to-use-docs/include-documentation.rst
@@ -6,6 +6,16 @@
Setting Up
==========
+ONAP documentation is stored in git repositories, changes are managed
+with gerrit reviews, and published documents generated when there is a
+change in any source used to build the documentation.
+
+Authors create source for documents in reStructured Text (RST) that is
+rendered to HTML and published on Readthedocs.io.
+The developer Wiki or other web sites can reference these rendered
+documents directly allowing projects to easily maintain current release
+documentation.
+
Some initial set up is required to connect a project with
the master document structure and enable automated publishing of
changes as summarized in the following diagram and description below
@@ -31,12 +41,12 @@ below.
PA <-- PR [label = "Merge" ];
}
-Setup project repositories(s)
------------------------------
+Setup project repositories
+--------------------------
These steps are performed for each project repository that
provides documentation.
-First let's set two variables that will be used in the subsequent steps.
+1. Set two variables that will be used in the subsequent steps.
Set *reponame* to the project repository you are setting up
just as it appears in the **Project Name** column of
the Gerrit projects page.
@@ -48,7 +58,7 @@ login to gerrit or for git clone requests over ssh.
reponame=
lfid=
-The next step is to add a directory in the doc project where your
+2. 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. Please note that the
@@ -90,7 +100,7 @@ place.
reference on changes and/or the verify job will fail in the step below.
-The last step is to create a docs directory in your repository with
+3. Create a docs directory in your repository with
an index.rst file. The following sequence will complete the minimum
required over ssh. As you have time to convert or add new content you
can update the index and add files under the docs folder.