.. title:: Beaker help

Resources
=========

.. container:: resourcesbox

   .. raw:: html

      <h3>for users</h3>

   .. toctree::
      :maxdepth: 1

      user-guide/index
      man/index
      Release notes <whats-new/index>
      glossary
      architecture-guide/index
      Restraint Test Harness <https://restraint.readthedocs.io/en/latest/>

   * :download:`RELAX NG schema for Beaker jobs <../Common/bkr/common/schema/beaker-job.rng>`

.. container:: resourcesbox

   .. raw:: html

      <h3>for administrators</h3>

   .. toctree::
      :maxdepth: 1

      in-a-box/index
      admin-guide/index
      architecture-guide/index

.. container:: resourcesbox

   .. raw:: html

      <h3>for developers</h3>

   .. toctree::
      :maxdepth: 1

      Beaker server API documentation <server-api/index>
      alternative-harnesses/index
      architecture-guide/index

   * `Beaker development documentation <../dev/guide>`_


Downloadable documentation
==========================

You can also download the `User Guide <user-guide.pdf>`_ or `Administration
Guide <admin-guide.pdf>`_ in PDF format in order to read it offline.

Getting further help
====================

The best way to interact with Beaker developers and users is in the `#beaker 
<irc://irc.libera.chat/beaker>`_ IRC channel on irc.libera.chat. The Beaker 
developers monitor this channel, and development discussions often happen 
there.

You can also ask your question by posting it to our `beaker-devel
<https://lists.fedorahosted.org/archives/list/beaker-devel@lists.fedorahosted.org/>`_
mailing list.

If you've found a bug in Beaker, please report it in `GitHub project
<https://github.com/beaker-project/beaker/issues>`__.

Presentations about Beaker
==========================

* *Beaker's hardware inventory system*
  (`video <https://www.youtube.com/watch?v=keNCbdYaIxg>`__,
  `slides <https://amitksaha.fedorapeople.org/lca2015/slides.html>`__).
  Nick Coghlan, Amit Saha, 2015
* *Full stack integration testing with Beaker*
  (`video <https://www.youtube.com/watch?v=tjUjdBm-Mqw>`__,
  `slides <https://bitbucket.org/ncoghlan/misc/src/default/talks/2014-01-linux.conf.au/beaker/>`__).
  Nick Coghlan, 2014
* *Scaling integration testing with Beaker*
  (`video <https://www.youtube.com/watch?v=UHIll_TmjDk>`__,
  `slides <http://www.curiousefficiency.org/uploads/flock-2013/beaker-ncoghlan.html>`__).
  Nick Coghlan, 2013
* *Beaker quick start guide*
  (`slides <../psss-beaker-quick-start-guide-slides.pdf>`__).
  Petr Šplíchal, 2011
