Documentation Link

https://matplotlib.org/devdocs/index.html

Problem

The install info at the top takes ~1/3 of the available vertical space on the front page (before scrolling, but taking into account the fact that the "real" version number will not have a git tag). While important, it is something that most users have to do only once, whereas they (hopefully) will consult the rest of the docs more than once; therefore, it could be made slightly less tall.

Suggested improvement

The current panels:

without scrolling (and with a "released" version), the page cuts on my screen just after "API reference".

A few options (just some quick hacks, certainly better styling is possible):



On my screen, without scrolling, the page cuts after the link to pyplot.figure with the first and last design, and after the link to pyplot.subplots_mosaic after the middle one. I think having these immediately visible is nice to have.

.. code-block:: bash

   # Using conda:
   conda install matplotlib
   # Or using pip:
   pip install matplotlib

.. csv-table::
   :widths: 1 3

   Using `conda <https://docs.continuum.io/anaconda/>`__,``conda install matplotlib``
   Using `pip <https://pypi.org/project/matplotlib>`__,``pip install matplotlib``

.. csv-table::
   :widths: 1 2 1 2

   Using `conda <https://docs.continuum.io/anaconda/>`__:,``conda install matplotlib``,Using `pip <https://pypi.org/project/matplotlib>`__:,``pip install matplotlib``

Matplotlib Version

master

Matplotlib documentation version

(local build)