docs: improve docs

Author: scanny

README.rst

@@ -1,16 +1,17 @@
-.. image:: https://travis-ci.org/scanny/python-pptx.svg?branch=master
-   :target: https://travis-ci.org/scanny/python-pptx
-
-*python-pptx* is a Python library for creating and updating PowerPoint (.pptx)
+*python-pptx* is a Python library for creating, reading, and updating PowerPoint (.pptx)
 files.
 
-A typical use would be generating a customized PowerPoint presentation from
-database content, downloadable by clicking a link in a web application.
-Several developers have used it to automate production of presentation-ready
-engineering status reports based on information held in their work management
-system. It could also be used for making bulk updates to a library of
-presentations or simply to automate the production of a slide or two that
-would be tedious to get right by hand.
+A typical use would be generating a PowerPoint presentation from dynamic content such as
+a database query, analytics output, or a JSON payload, perhaps in response to an HTTP
+request and downloading the generated PPTX file in response. It runs on any Python
+capable platform, including macOS and Linux, and does not require the PowerPoint
+application to be installed or licensed.
+
+It can also be used to analyze PowerPoint files from a corpus, perhaps to extract search
+indexing text and images.
+
+In can also be used to simply automate the production of a slide or two that would be
+tedious to get right by hand, which is how this all got started.
 
 More information is available in the `python-pptx documentation`_.
 

docs/index.rst

@@ -7,10 +7,21 @@ Release v\ |version| (:ref:`Installation <install>`)
 .. include:: ../README.rst
 
 
+Philosophy
+----------
+
+|pp| aims to broadly support the PowerPoint format (PPTX, PowerPoint 2007 and later),
+but its primary commitment is to be _industrial-grade_, that is, suitable for use in a
+commercial setting. Maintaining this robustness requires a high engineering standard
+which includes a comprehensive two-level (e2e + unit) testing regimen. This discipline
+comes at a cost in development effort/time, but we consider reliability to be an
+essential requirement.
+
+
 Feature Support
 ---------------
 
-|pp| has the following capabilities, with many more on the roadmap:
+|pp| has the following capabilities:
 
 * Round-trip any Open XML presentation (.pptx file) including all its elements
 * Add slides
@@ -21,11 +32,18 @@ Feature Support
 * Add auto shapes (e.g. polygons, flowchart shapes, etc.) to a slide
 * Add and manipulate column, bar, line, and pie charts
 * Access and change core document properties such as title and subject
+* And many others ...
+
+Even with all |pp| does, the PowerPoint document format is very rich and there are still
+features |pp| does not support.
+
+
+New features/releases
+---------------------
 
-Additional capabilities are actively being developed and added on a release
-cadence of roughly once per month. If you find a feature you need that |pp|
-doesn't yet have, reach out via the mailing list or issue tracker and we'll see
-if we can jump the queue for you to pop it in there :)
+New features are generally added via sponsorship. If there's a new feature you need for
+your use case, feel free to reach out at the email address on the github.com/scanny
+profile page. Many of the most used features such as charts were added this way.
 
 
 User Guide