diff --git a/doc/contributor-guide/source/first-timers-quickstart.rst b/doc/contributor-guide/source/first-timers-quickstart.rst index f5e88df8ce..21e2612c16 100644 --- a/doc/contributor-guide/source/first-timers-quickstart.rst +++ b/doc/contributor-guide/source/first-timers-quickstart.rst @@ -21,7 +21,7 @@ Other good first-time documentation tasks are bug triaging and bug fixing: #. If you are up for it, assign the bug to yourself after it has been confirmed by one other person. Fix it by committing the required changes - to the OpenStack documentation. + to OpenStack documentation. The following diagram shows the basic setup workflow: diff --git a/doc/contributor-guide/source/rst-conv.rst b/doc/contributor-guide/source/rst-conv.rst index e6b9c7a94c..957013ad33 100644 --- a/doc/contributor-guide/source/rst-conv.rst +++ b/doc/contributor-guide/source/rst-conv.rst @@ -7,10 +7,10 @@ RST formatting conventions OpenStack documentation uses reStructuredText (RST) markup syntax with Sphinx extensions. -RST is a powerful and straightforward markup language, that in combination +RST is a powerful and straightforward markup language that, in combination with Sphinx, provides a wide range of facilities for intelligent and -good-looking documentation creation. It uses simple and implicit -syntax to introduce a wide range of content elements, such as, titles, +appealing documentation creation. It uses simple and implicit +syntax to introduce a variety of content elements such as titles, code blocks, vertical lists, and many others. All the source content formatted using RST is stored in files with the ``.rst`` extension.