Update resource section

doc/getting_started/overview.rst

@@ -31,6 +31,8 @@ handled automatically. Building on this declarative plotting idea, a surprising
 of simple to sophisticated plots and visualizations can be created using a relatively
 concise grammar.
 
+This documentation serves as the main reference for learning about Altair, and additional learning material and tutorials can be found in the :ref:`learning-resources` section.
+
 .. _Vega: http://vega.github.io/vega
 .. _Vega-Lite: http://vega.github.io/vega-lite
 

doc/user_guide/ecosystem.rst

@@ -1,69 +1,162 @@
 .. _ecosystem:
 
-Ecosystem
+Resources
 =========
 
-This is a list of projects related to or built on top of Altair. We hope to make it easier to find these projects by listing them here. If you know of a project that should be added, please let us know.
+We hope to make it easier to find learning resources and projects related to Altair by listing them here. If you know of a project that should be added, please let us know by opening an `Issue on GitHub <https://github.com/altair-viz/altair/issues>`_.
 
-altair_recipes_
----------------
+.. _learning-resources:
+
+Learning Material
+-----------------
+
+This is a list of learning material that complements the official documentation and can help you learn more about how to use Altair.
 
-altair-recipes provides a collection of ready-made statistical graphics for vega. See the `docs <https://altair-recipes.readthedocs.io/en/latest/>`__.
+`Visualization Curriculum`_
+~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+A data visualization curriculum from the UW data group that developed Vega-Lite.
 
 .. List of links.
-.. _altair_recipes: https://github.com/piccolbo/altair_recipes
+.. _`Visualization Curriculum`: https://uwdata.github.io/visualization-curriculum
 
-gpdvega_
---------
+`Jupyter Notebook Tutorials`_
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-gpdvega is a bridge between GeoPandas_, a geospatial extension of Pandas_, and Altair which allows to seamlessly chart geospatial data using altair. See the `docs <https://iliatimofeev.github.io/gpdvega/>`__.
+Jupyter Notebook tutorials and examples from the Altair authors.
 
 .. List of links.
-.. _gpdvega: https://github.com/iliatimofeev/gpdvega
-.. _GeoPandas: http://geopandas.org/
-.. _Pandas: https://pandas.pydata.org/
+.. _`Jupyter Notebook Tutorials`: https://github.com/altair-viz/altair_notebooks
 
-nx_altair_
-----------
+`Pycon Tutorial`_
+~~~~~~~~~~~~~~~~~
 
-nx_altair is a library for drawing NetworkX_ graphs using Altair. It offers a similar draw API as NetworkX but returns Altair Charts instead. This allows users to apply Altair's rich interactive API to networks graphs. See the `docs <https://github.com/Zsailer/nx_altair/blob/master/examples/nx_altair-tutorial.ipynb>`__.
+Altair tutorial given at PyCon 2018 by the Altair author Jake VanderPlas.
 
 .. List of links.
-.. _nx_altair: https://github.com/Zsailer/nx_altair
-.. _NetworkX: https://networkx.github.io/
+.. _`Pycon tutorial`: https://altair-viz.github.io/altair-tutorial
 
-pdvega_
--------
+`Data Visualization Course`_
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-pdvega is a library that allows you to quickly create interactive Vega-Lite_ plots from Pandas_ dataframes, using an API that is nearly identical to Pandas' built-in visualization tools, and designed for easy use within the Jupyter_ notebook. See the `docs <https://altair-viz.github.io/pdvega/>`__.
+This course covers how to create common statistical visualizations, tell stories with data, create geographical visualizations, and bring plots to life by adding interactive elements. Created at the University of British Columbia and can either be audited or taken as part of the `Key Capabilities for Data Science`_ certificate program.
 
+.. List of links.
+.. _`Data Visualization Course`: https://viz-learn.mds.ubc.ca
+.. _`Key Capabilities for Data Science`: https://extendedlearning.ubc.ca/programs/key-capabilities-data-science
+
+`Brief Introduction Videos`_
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+Calmcode provides a few videos that give a brief overview of the Altair library.
 
 .. List of links.
-.. _pdvega: https://github.com/altair-viz/pdvega
-.. _Vega-Lite: https://vega.github.io/vega-lite/
-.. _Jupyter: http://jupyter.org/
+.. _`Brief Introduction Videos`: https://calmcode.io/altair/introduction.html
 
-`Altair in R`_
---------------
-Altair in R provides an R interface to the Altair Python package. See the `docs <https://vegawidget.github.io/altair/>`__.
+
+.. _altair-ecosystem:
+
+Related Projects
+----------------
+
+This is a list of projects which are directly related to Altair. There are many other packages that can be used in tandem with Altair, e.g. `dashboard packages which you can read more about in the answers to this StackOverflow question`_.
 
 .. List of links.
-.. _`Altair in R`: https://github.com/vegawidget/altair
+.. _`dashboard packages which you can read more about in the answers to this StackOverflow question`: https://stackoverflow.com/questions/49833866/making-dashboards-using-altair
+
+Vega-Lite_
+~~~~~~~~~~
+
+The higher-level visualization grammar that Altair implements in Python.
+
+.. List of links.
+.. _Vega-Lite: https://vega.github.io/vega-lite
+
+vl-convert_
+~~~~~~~~~~~
+
+Python library for converting Altair/Vega-Lite chart specifications into static images (SVG or PNG) or Vega chart specifications without any external dependencies.
+
+.. List of links.
+.. _vl-convert: https://github.com/vega/vl-convert
+
+VegaFusion_
+~~~~~~~~~~~
+
+VegaFusion provides server-side scaling for Altair charts, which can accelerate interactive charts, extract transformed data, and perform data-intensive aggregations on the server and prune unused columns from the source dataset yielding smaller size visualizations.
+
+.. List of links.
+.. _VegaFusion: https://vegafusion.io/
+
+altair_saver_
+~~~~~~~~~~~~~
+
+Enables saving charts to a variety of output types.
+
+.. List of links.
+.. _altair_saver: https://github.com/altair-viz/altair_saver
+
+altair_data_server_
+~~~~~~~~~~~~~~~~~~~
 
-starborn_
----------
+Data transformer plugin that transparently serves data for charts.
 
-Starborn is a Python visualization library based on Vega and Altair that aims to be API-compatible with Seaborn_. Like Seaborn, it provides a high-level interface for drawing attractive statistical graphics. Thanks to the underlying libraries, it can also offer interactivity with in-browser panning and zooming. See the `docs <https://github.com/PythonCharmers/starborn/blob/master/doc/starborn_examples.ipynb>`__.
+.. List of links.
+.. _altair_data_server: https://github.com/altair-viz/altair_data_server
 
+altair_pandas_
+~~~~~~~~~~~~~~
+
+Altair backend for the pandas plotting API.
 
 .. List of links.
-.. _starborn: https://github.com/PythonCharmers/starborn
-.. _Seaborn: https://seaborn.pydata.org/index.html
+.. _altair_pandas: https://github.com/altair-viz/altair_pandas
+
+vega_datasets_
+~~~~~~~~~~~~~~
+
+Offline access to the Vega datasets used in the Altair documentation.
+
+.. List of links.
+.. _vega_datasets: https://github.com/altair-viz/vega_datasets
+
+altair_recipes_
+~~~~~~~~~~~~~~~
+
+altair_recipes provides a collection of ready-made statistical graphics for Altair. See the `docs <https://altair-recipes.readthedocs.io/en/latest/>`__.
+
+.. List of links.
+.. _altair_recipes: https://github.com/piccolbo/altair_recipes
+
+nx_altair_
+~~~~~~~~~~
+
+nx_altair is a library for drawing NetworkX_ graphs using Altair. It offers a similar draw API as NetworkX but returns Altair Charts instead. This allows users to apply Altair's rich interactive API to networks graphs. See the `docs <https://github.com/Zsailer/nx_altair/blob/master/examples/nx_altair-tutorial.ipynb>`__.
+
+.. List of links.
+.. _nx_altair: https://github.com/Zsailer/nx_altair
+.. _NetworkX: https://networkx.github.io/
+
+`Altair Ally`_
+~~~~~~~~~~~~~~
+
+Altair Ally is a companion package to Altair, which provides a few shortcuts to create common plots for exploratory data analysis, particularly those involving visualization of an entire dataframe.
+
+.. List of links.
+.. _`Altair Ally`: https://joelostblom.github.io/altair_ally
 
 gif_
-----
+~~~~
 
 gif is the extension for Altair and matplotlib animations. The library provides a simple, high-level decorator interface to create frames in a regular for-loop that can be stitched together on save. See the `docs <https://github.com/maxhumber/gif>`__.
 
 .. List of links.
 .. _gif: https://github.com/maxhumber/gif
+
+`Altair in R`_
+~~~~~~~~~~~~~~
+
+Altair in R provides an R interface to the Altair Python package. See the `docs <https://vegawidget.github.io/altair/>`__.
+
+.. List of links.
+.. _`Altair in R`: https://github.com/vegawidget/altair

sphinxext/altairgallery.py

@@ -38,16 +38,16 @@
 {{ title }}
 {% for char in title %}-{% endfor %}
 
-This gallery contains a selection of examples of the plots Altair can create.
-
-Some may seem fairly complicated at first glance, but they are built by combining a simple set of declarative building blocks.
+This gallery contains a selection of examples of the plots Altair can create. Some may seem fairly complicated at first glance, but they are built by combining a simple set of declarative building blocks.
 
 Many draw upon sample datasets compiled by the `Vega <https://vega.github.io/vega/>`_ project. To access them yourself, install `vega_datasets <https://github.com/altair-viz/vega_datasets>`_.
 
 .. code-block:: none
 
    python -m pip install vega_datasets
 
+If you can't find the plots you are looking for here, make sure to check out the :ref:`altair-ecosystem` section, which has links to packages for making e.g. network diagrams and animations.
+
 {% for grouper, group in examples %}
 
 .. _gallery-category-{{ grouper }}: