.. _examples:

Examples
========

Examples show the steps that demonstrate how something was done,
often with minimal explanation.

In addition to the examples presented below, there are many Jupyter notebooks
online to provide additional
`Bluesky training <https://github.com/BCDA-APS/bluesky_training#notebooks>`__
for the APS.  Further, NSLS-II provides online notebooks which can be
`executed online <https://try.nsls2.bnl.gov>`__ (in a web browser).
See the `Bluesky home page <https://blueskyproject.io/>`__ for more details.

.. Consider re-organizing and writing new content in one of these categories:

  Tutorials
  How-to guides
  Reference
  Explanation

.. icons: https://fonts.google.com/icons
.. grid:: 2

    .. grid-item-card:: :material-regular:`precision_manufacturing;3em` Devices
      :link: device_examples
      :link-type: doc

      .. toctree::
         :maxdepth: 1
         :glob:
         :hidden:

         device_examples

    .. grid-item-card:: :material-regular:`save;3em` File Writers
      :link: filewriter_examples
      :link-type: doc

      .. toctree::
         :maxdepth: 1
         :glob:
         :hidden:

         filewriter_examples

    .. grid-item-card:: :material-regular:`how_to_reg;3em` How-To
      :link: howto_examples
      :link-type: doc

      .. toctree::
         :maxdepth: 1
         :glob:
         :hidden:

         howto_examples

    .. grid-item-card:: :material-regular:`task;3em` Plans
      :link: plan_examples
      :link-type: doc

      .. toctree::
         :maxdepth: 1
         :glob:
         :hidden:

         plan_examples

    .. grid-item-card:: :material-regular:`download;3em` Downloads
      :link: download_examples
      :link-type: doc

      .. toctree::
         :maxdepth: 1
         :glob:
         :hidden:

         download_examples