Merge pull request #21313 from timhoffm/getting-started

dstansby · web-flow · commit 355739261a8b · 2021-10-09T19:20:20.000+01:00
DOC: Minimal getting started page
diff --git a/doc/_static/mpl.css b/doc/_static/mpl.css
@@ -231,3 +231,17 @@ table.property-table td {
     /* fix width to width of cheatsheet */
     width: 210px;
 }
+
+/* Two columns for install code blocks */
+div.twocol {
+    padding-left: 0;
+    padding-right: 0;
+    display: flex;
+    gap: 20px;
+}
+
+div.twocol > div {
+    flex-grow: 1;
+    padding: 0;
+    margin: 0;
+}
diff --git a/doc/users/getting_started.rst b/doc/users/getting_started.rst
@@ -0,0 +1,54 @@
+Getting started
+===============
+
+Installation
+------------
+
+.. container:: twocol
+
+    .. container::
+
+        Install using pip:
+
+        .. code-block:: bash
+
+            pip install matplotlib
+
+    .. container::
+
+        Install using conda:
+
+        .. code-block:: bash
+
+            conda install matplotlib
+
+Further details are available in the :doc:`Installation Guide </users/installing>`.
+
+
+Draw a first plot
+-----------------
+
+Here is a minimal example plot you can try out:
+
+.. plot::
+   :include-source:
+   :align: center
+
+   import matplotlib.pyplot as plt
+   import numpy as np
+
+   x = np.linspace(0, 2 * np.pi, 200)
+   y = np.sin(x)
+
+   fig, ax = plt.subplots()
+   ax.plot(x, y)
+   plt.show()
+
+
+Where to go next
+----------------
+
+- Check out :doc:`Plot types </plot_types/index>` to get an overview of the
+  types of plots you can create with Matplotlib.
+- Learn Matplotlib from the ground up in the
+  :doc:`Quick-start guide </tutorials/introductory/usage>`.
diff --git a/doc/users/index.rst b/doc/users/index.rst
@@ -10,6 +10,7 @@ Usage guide
    ../plot_types/index.rst
    ../tutorials/index.rst
    ../gallery/index.rst
+   getting_started.rst
    explain.rst
    ../faq/index.rst
    ../api/index.rst
