Merge pull request #241 from asmacdo/cleanup-core-division

Cleanup index to be consistent with pulpcore

Author: asmacdo

docs/index.rst

@@ -2,22 +2,24 @@ pulp-python Plugin
 ==================
 
 The ``pulp_python`` plugin extends `pulpcore <https://pypi.python.org/pypi/pulpcore/>`_ to support
-hosting pip compatible Python packages similarly to the `Python Package Index
-<https://pypi.org/>`_.
+hosting pip compatible Python packages like the `Python Package Index <https://pypi.org/>`_.
 
 How to use these docs
 ---------------------
 
 The documentation here should be considered **the primary documentation for managing Python
-content**. All relevent workflows are covered here, with references to some pulpcore supplemental
-docs. Users may also find `pulpcore's conceptual docs
-<https://docs.pulpproject.org/en/3.0/nightly/concepts.html>`_ useful. Here, the documentation falls
-into two main categories:
+content**. See `How to navigate the pulpcore and plugin docs
+<https://docs.pulpproject.org/en/3.0/nightly/index.html#how-to-navigate-the-pulpcore-and-plugin-docs>`_
+for a more thorough explanation.
+
+All relevent workflows are covered here, with references to pulpcore supplemental docs. Users may
+also find `pulpcore's conceptual docs <https://docs.pulpproject.org/en/3.0/nightly/concepts.html>`_
+helpful. Here, the documentation falls into two main categories:
 
   1. :ref:`workflows-index` show the **major features** of the Python plugin, with links to reference
      docs.
-  2. `REST API Docs <restapi.html>`_ are automatically generated and provide more detailed
-     information for each **minor feature**, including all fields and options.
+  2. `REST API Docs <restapi.html>`_ are automatically generated and are responsible for containing
+     thorough information for each **minor feature**, including all fields and options.
 
 Community
 ---------
@@ -29,7 +31,7 @@ Also, contributions are greatly appreciated in the form of:
   2. `Github Pull Requests <https://github.com/pulp/pulp_python>`_
   3. `Helping other users <https://docs.pulpproject.org/en/3.0/nightly/#community>`_
 
-We can usually be found on freenode in `pulp-dev`, `pulp`, and `pulp-python`.
+We can usually be found on freenode in `#pulp-dev`, `#pulp`, and `#pulp-python`.
 
 Table of Contents
 -----------------