Merge pull request #16226 from timhoffm/doc-overview

story645 · web-flow · commit e4dbf4e7b524 · 2020-01-29T23:33:22.000-05:00
Reorganize intro section on main page
diff --git a/doc/_static/mpl.css b/doc/_static/mpl.css
@@ -1219,3 +1219,38 @@ hr.box-sep {
         flex: 0 0 90%;
     }
 }
+
+/* bullet boxes on main page */
+div.bullet-box-container {
+    display: flex;
+    flex-wrap: wrap;
+    margin: 1em 0;
+}
+
+div.bullet-box {
+    flex-grow: 1;
+    width: 28%;
+    margin: 0.4em;
+    padding: 0 1em;
+    background: #eff9ff;
+}
+
+div.bullet-box p:first-of-type {
+    font-size: 1.4em;
+    text-align: center;
+}
+
+div.bullet-box ul {
+    padding-left: 1.2em;
+}
+
+div.bullet-box li {
+    padding-left: 0.3em;
+    margin-bottom: 0.3em;
+}
+
+@media only screen and (max-width: 930px){
+    div.bullet-box {
+        flex: 0 0 90%;
+    }
+}
diff --git a/doc/index.rst b/doc/index.rst
@@ -2,14 +2,11 @@
 
 .. title:: Matplotlib: Python plotting
 
-Matplotlib is a Python 2D plotting library which produces publication quality
-figures in a variety of hardcopy formats and interactive environments across
-platforms.  Matplotlib can be used in Python scripts, the Python and IPython_
-shells, the Jupyter_ notebook, web application servers, and four graphical user
-interface toolkits.
+Matplotlib: Visualization with Python
+-------------------------------------
 
-.. _IPython: http://ipython.org
-.. _Jupyter: http://jupyter.org
+Matplotlib is a comprehensive library for creating static, animated,
+and interactive visualizations in Python.
 
 .. raw:: html
 
@@ -35,32 +32,48 @@ interface toolkits.
    </div>
    <span class="clear_screenshots"></span>
 
-Matplotlib tries to make easy things easy and hard things possible.  You
-can generate plots, histograms, power spectra, bar charts, errorcharts,
-scatterplots, etc., with just a few lines of code.  For examples, see the
-:doc:`sample plots <tutorials/introductory/sample_plots>` and :doc:`thumbnail
-gallery <gallery/index>`.
+Matplotlib makes easy things easy and hard things possible.
 
-For simple plotting the :mod:`.pyplot` module provides a MATLAB-like interface,
-particularly when combined with IPython.  For the power user, you have full
-control of line styles, font properties, axes properties, etc, via an object
-oriented interface or via a set of functions familiar to MATLAB users.
+.. container:: bullet-box-container
+
+   .. container:: bullet-box
+
+      Create
+
+      - Develop `publication quality plots`_ with just with just a few lines of code
+      - Use `interactive figures`_ that can zoom, pan, update...
+
+      .. _publication quality plots: https://matplotlib.org/gallery/index.html
+      .. _interactive figures: https://matplotlib.org/gallery/index.html#event-handling
+
+   .. container:: bullet-box
+
+      Customize
+
+      - `Take full control`_ of line styles, font properties, axes properties...
+      - `Export and embed`_ to a number of file formats and interactive environments
+
+      .. _Take full control: https://matplotlib.org/tutorials/index.html#tutorials
+      .. _Export and embed: https://matplotlib.org/api/index_backend_api.html
+
+   .. container:: bullet-box
+
+      Extend
+
+      - Explore tailored functionality provided by
+        :doc:`third party packages <thirdpartypackages/index>`
+      - Learn more about matplotlib through the many
+        :doc:`external learning resources <resources/index>`
 
 Documentation
--------------
+~~~~~~~~~~~~~
 
 To get started, read the :doc:`User's Guide <users/index>`.
 
 Trying to learn how to do a particular kind of plot?  Check out the
 :doc:`examples gallery <gallery/index>` or the :doc:`list of plotting commands
 <api/pyplot_summary>`.
 
-Other learning resources
-~~~~~~~~~~~~~~~~~~~~~~~~
-
-There are many :doc:`external learning resources <resources/index>` available
-including printed material, videos and tutorials.
-
 Join our community!
 ~~~~~~~~~~~~~~~~~~~
 
