DOC: add description of composite marks
@@ -10,7 +10,7 @@ used to map columns to visual attributes of the plot.
The ``mark`` property is what specifies how exactly those attributes
should be represented on the plot.
-Altair provides a number of mark properties:
+Altair provides a number of basic mark properties:
========== ============================ =================================================== ====================================
Mark Name Method Description Example
@@ -28,6 +28,16 @@ text :meth:`~Chart.mark_text` A scatter plot with points represented
tick :meth:`~Chart.mark_tick` A vertical or horizontal tick mark. :ref:`gallery_strip_plot`
========== ============================ =================================================== ====================================
+In addition, Altair provides the following compound marks:
+
+========== ============================== ================================ ==================================
+Mark Name Method Description Example
+========== ============================== ================================ ==================================
+box plot :meth:`~Chart.mark_boxplot` A box plot. :ref:`gallery_boxplot_max_min`
+error band :meth:`~Chart.mark_errorband` A continuous band around a line. N/A
+error bar :meth:`~Chart.mark_errorbar` An errorbar around a point. N/A
+========== ============================== ================================ ==================================
+
In Altair, marks can be most conveniently specified by the ``mark_*`` methods
of the Chart object, which take optional keyword arguments that are passed to
:class:`MarkDef` to configure the look of the marks.
