Docs front page text tweaks

doc/index.rst

@@ -6,34 +6,34 @@ Welcome to CKAN's documentation! These docs are organized into several guides,
 each guide serves a different audience of CKAN users or contributors:
 
 :doc:`user-guide`
-  The guide for people who will be using a CKAN site through its web interface.
-  Explains how to use the web interface and its features.
+  The guide for people who will be using a CKAN site through its web interface,
+  explains how to use the web interface and its features.
 
 :doc:`sysadmin-guide`
-  The guide for people with a sysadmin account on a CKAN site.
-  Explains how to use the sysadmin features of the CKAN web interface.
+  The guide for people with a sysadmin account on a CKAN site,
+  explains how to use the sysadmin features of the CKAN web interface.
 
 :doc:`/maintaining/index`
-  The guide for people who will be maintaining a CKAN site. Explains how to
+  The guide for people who will be maintaining a CKAN site, explains how to
   install, upgrade and configure CKAN and its features and extensions.
 
 :doc:`/api/index`
-  The guide for API developers who want to write code that interacts
-  with CKAN sites and their data.
+  The guide for API developers, explains how to write code that interacts with
+  CKAN sites and their data.
 
 :doc:`/extensions/index`
-  The guide for extension developers who want to customize and extend CKAN's
-  features.
+  The guide for extension developers, explains how to customize and extend
+  CKAN's features.
 
 :doc:`/theming/index`
-  The guide for theme developers who want to customize the appearance and
+  The guide for theme developers, explains how to customize the appearance and
   content of CKAN's web interface.
 
 :doc:`/contributing/index`
-  The guide for people who want to contribute to CKAN itself.
-  Documents the different processes for contributing to CKAN, including
-  reporting bugs, testing and QA, translating CKAN, helping with CKAN's
-  documentation, and contributing to the CKAN code.
+  The guide for people who want to contribute to CKAN itself,
+  explains how to make all kinds of contributions to CKAN,
+  including reporting bugs, testing and QA, translating CKAN, helping with
+  CKAN's documentation, and contributing to the CKAN code.
 
 Finally, the :doc:`/changelog` documents the differences between CKAN releases,
 useful information for anyone who is using CKAN.