diff --git a/doc/source/documentation.rst b/doc/source/documentation.rst index 3523215..4f22437 100644 --- a/doc/source/documentation.rst +++ b/doc/source/documentation.rst @@ -36,17 +36,18 @@ typically written in an REST API reference format such as WADL or Swagger and published to `developer.openstack.org `_. The API working group has published `guidelines for OpenStack APIs `_. -Documentation for Operators -=========================== +Documentation for Operators and Users +===================================== -Full length operating manuals for OpenStack are managed in their own -repositories and are written using RST. Often these manuals are -authored by operators themselves, with help from project teams. +OpenStack projects maintain their own documentation for operators and +end users. This includes information on running and operating the software, +concept guides, reference documentation, and more. There are also full-length +manuals for OpenStack operators and users available, managed in their own +repositories. Often these manuals are authored by operators and users +themselves, with help from project teams. How to Contribute Documentation =============================== -The documentation team maintains a `guide with instructions on how -to contribute documentation `_. -To look up the source for a particular document, refer to the -`content specification page `_. +The documentation team maintains a +`guide with instructions on how to contribute documentation `_.