Merge pull request matplotlib#20737 from jklymak/doc-new-doc-index

DOC: new index page

Author: story645

doc/index.rst

@@ -1,224 +1,45 @@
 :orphan:
 
-.. title:: Matplotlib: Python plotting
+.. title:: Matplotlib documentation
 
 .. module:: matplotlib
 
-Matplotlib: Visualization with Python
--------------------------------------
+Matplotlib documentation 
+------------------------
+
+Release: |release|
 
 Matplotlib is a comprehensive library for creating static, animated,
 and interactive visualizations in Python.
 
-.. raw:: html
-
-   <div class="responsive_screenshots">
-      <a href="tutorials/introductory/sample_plots.html">
-         <div class="responsive_subfig">
-         <img align="middle" src="_images/sphx_glr_membrane_thumb.png"
-          border="0" alt="screenshots"/>
-         </div>
-         <div class="responsive_subfig">
-         <img align="middle" src="_images/sphx_glr_histogram_thumb.png"
-          border="0" alt="screenshots"/>
-         </div>
-         <div class="responsive_subfig">
-         <img align="middle" src="_images/sphx_glr_contour_thumb.png"
-          border="0" alt="screenshots"/>
-         </div>
-         <div class="responsive_subfig">
-         <img align="middle" src="_images/sphx_glr_3D_thumb.png"
-          border="0" alt="screenshots"/>
-         </div>
-      </a>
-   </div>
-   <span class="clear_screenshots"></span>
-
-Matplotlib makes easy things easy and hard things possible.
-
-.. container:: bullet-box-container
-
-   .. container:: bullet-box
-
-      Create
-
-      - Develop `publication quality plots`_ 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
-        `third party packages <https://matplotlib.org/mpl-third-party/>`_
-      - 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>`.
-
-Join our community!
-~~~~~~~~~~~~~~~~~~~
-
-Matplotlib is a welcoming, inclusive project, and everyone within the community
-is expected to abide by our `code of conduct
-<https://github.com/matplotlib/matplotlib/blob/master/CODE_OF_CONDUCT.md>`_.
-
-
-.. raw:: html
-
-    <h3>Get help</h3>
-    <div class="box">
-      <div class="box-item">
-        <img src="_static/fa/discourse-brands.svg" alt="Discourse">
-        <p>Join our community at <a href="https://discourse.matplotlib.org">discourse.matplotlib.org</a>
-        to get help, discuss contributing &amp; development, and share your work.</p>
-      </div>
-      <div class="box-item">
-        <img src="_static/fa/question-circle-regular.svg" alt="Questions">
-        <p>If you have questions, be sure to check the <a href="faq/index.html">FAQ</a>,
-        the <a href="api/index.html">API</a> docs. The full text
-        <a href="search.html">search</a> is a good way to discover the docs including the many examples.</p>
-      </div>
-      <div class="box-item">
-        <img src="_static/fa/stack-overflow-brands.svg" alt="Stackoverflow">
-        <p>Check out the Matplotlib tag on <a href="https://stackoverflow.com/questions/tagged/matplotlib">stackoverflow</a>.</p>
-      </div>
-      <div class="box-item">
-        <img src="_static/fa/gitter-brands.svg" alt="Gitter">
-        <p>Short questions may be posted on the <a href="https://gitter.im/matplotlib/matplotlib">gitter channel</a>.</p>
-      </div>
-    </div>
-    <hr class='box-sep'>
-    <h3>News</h3>
-    <div class="box">
-      <div class="box-item">
-        <img src="_static/fa/plus-square-regular.svg" alt="News">
-        <p>To keep up to date with what's going on in Matplotlib, see the
-        <a href="users/whats_new.html">what's new</a> page or browse the
-        <a href="https://github.com/matplotlib/matplotlib">source code</a>.  Anything that could
-        require changes to your existing code is logged in the
-        <a href="api/api_changes.html">API changes</a> file.</p>
-      </div>
-      <div class="box-item">
-        <img src="_static/fa/hashtag-solid.svg" alt="Social media">
-        <ul>
-        <li>Tweet us at <a href="https://twitter.com/matplotlib">@matplotlib</a>!</li>
-        <li>See cool plots on <a href="https://www.instagram.com/matplotart/">@matplotart</a> Instagram!</li>
-        <li>Check out our <a href="https://matplotlib.org/matplotblog/">Blog</a>!</li>
-        </ul>
-      </div>
-    </div>
-    <hr class='box-sep'>
-    <h3>Development</h3>
-    <div class="box">
-      <div class="box-item">
-        <img src="_static/fa/github-brands.svg" alt="Github">
-        <p>Matplotlib is hosted on <a href="https://github.com/matplotlib/matplotlib">GitHub</a>.</p>
-        <ul>
-        <li>File bugs and feature requests on the <a href="https://github.com/matplotlib/matplotlib/issues">issue tracker</a>.</li>
-        <li><a href="https://github.com/matplotlib/matplotlib/pulls">Pull requests</a> are always welcome.</li>
-        </ul>
-        <p>It is a good idea to ping us on <a href="https://discourse.matplotlib.org">Discourse</a> as well.</p>
-      </div>
-      <div class="box-item">
-        <img src="_static/fa/envelope-regular.svg" alt="Mailing lists">
-        <p>Mailing lists</p>
-        <ul>
-        <li><a href="https://mail.python.org/mailman/listinfo/matplotlib-users">matplotlib-users</a> for usage questions</li>
-        <li><a href="https://mail.python.org/mailman/listinfo/matplotlib-devel">matplotlib-devel</a> for development</li>
-        <li><a href="https://mail.python.org/mailman/listinfo/matplotlib-announce">matplotlib-announce</a> for project announcements</li>
-        </ul>
-      </div>
-    </div>
-
-
-Toolkits
-========
-
-Matplotlib ships with several add-on :doc:`toolkits <api/toolkits/index>`,
-including 3D plotting with `.mplot3d`, axes helpers in `.axes_grid1` and axis
-helpers in `.axisartist`.
-
-Third party packages
-====================
-
-A large number of 
-`third party packages <https://matplotlib.org/mpl-third-party/>`_
-extend and build on Matplotlib functionality, including several higher-level
-plotting interfaces (seaborn_, HoloViews_, ggplot_, ...), and a projection
-and mapping toolkit (Cartopy_).
-
-.. _seaborn: https://seaborn.pydata.org
-.. _HoloViews: https://holoviews.org
-.. _ggplot: https://yhat.github.io/ggpy/
-.. _Cartopy: https://scitools.org.uk/cartopy/docs/latest/
-
-Citing Matplotlib
-=================
-
-Matplotlib is the brainchild of John Hunter (1968-2012), who, along with its
-many contributors, have put an immeasurable amount of time and effort into
-producing a piece of software utilized by thousands of scientists worldwide.
-
-If Matplotlib contributes to a project that leads to a scientific publication,
-please acknowledge this work by citing the project. A :doc:`ready-made citation
-entry <citing>` is available.
-
-Open source
-===========
-
-.. raw:: html
-
-   <a href="https://numfocus.org/">
-   <img src="_static/numfocus_badge.png"
-    alt="A Fiscally Sponsored Project of NUMFocus"
-    style="float:right; margin-left:20px" />
-   </a>
-
+Learn
+=====
+      
+- :doc:`Quick-start Guide <tutorials/introductory/usage>`
+- Basic :doc:`Plot Types <plot_types/index>` and :doc:`Example Gallery <gallery/index>`
+- `Introductory Tutorials <../tutorials/index.html#introductory>`_
+      
+Reference
+=========
 
-Matplotlib is a Sponsored Project of NumFOCUS, a 501(c)(3) nonprofit
-charity in the United States. NumFOCUS provides Matplotlib with
-fiscal, legal, and administrative support to help ensure the health
-and sustainability of the project. Visit `numfocus.org <nf_>`_ for more
-information.
+- :doc:`API Reference <api/index>`
 
-Donations to Matplotlib are managed by NumFOCUS. For donors in the
-United States, your gift is tax-deductible to the extent provided by
-law. As with any donation, you should consult with your tax adviser
-about your particular tax situation.
+  - :doc:`pyplot API <api/pyplot_summary>`: top-level interface to create 
+    Figures (`.pyplot.figure`) and Subplots (`.pyplot.subplots`, 
+    `.pyplot.subplot_mosaic`)
+  - :doc:`Axes API <api/axes_api>` for *most* plotting methods
+  - :doc:`Figure API <api/figure_api>` for figure-level methods
 
-Please consider `donating to the Matplotlib project <donating_>`_ through
-the NumFOCUS organization or to the `John Hunter Technology Fellowship
-<jdh-fellowship_>`_.
+- :doc:`Extra Toolkits <api/toolkits/index>`
 
-.. _donating: https://numfocus.org/donate-to-matplotlib
-.. _jdh-fellowship: https://numfocus.org/programs/john-hunter-technology-fellowship/
-.. _nf: https://numfocus.org
+How-tos
+=======
 
-The :doc:`Matplotlib license <users/license>` is based on the `Python Software
-Foundation (PSF) license <psf-license_>`_.
+- :doc:`Installation Guide <users/installing>`
+- :doc:`Contributing to Matplotlib <devel/index>`
+- :doc:`Matplotlib FAQ <faq/index>`
 
-.. _psf-license: https://docs.python.org/3/license.html
+Understand how Matplotlib works
+===============================
 
-There is an active developer community and a long list of people who have made
-significant :doc:`contributions <users/credits>`.
+- Many of the :doc:`Tutorials <tutorials/index>` have explanatory material