.. AutoQA documentation master file, created by
   sphinx-quickstart on Fri Jul  1 12:00:33 2011.
   You can adapt this file completely to your liking, but it should at least
   contain the root `toctree` directive.

.. text subsitution definitions
.. |current fedora| replace:: 15
.. |next fedora| replace:: 16

.. links used in this document
.. _branched: https://fedoraproject.org/wiki/Releases/Branched
.. _rawhide: https://fedoraproject.org/wiki/Releases/Rawhide

==================================
AutoQA
==================================

**AutoQA** is an automated test system for Fedora.  Its design is simple: when certain events occur, AutoQA launches automated tests.  Events that AutoQA monitors include:

* New packages in the `koji build system <http://koji.fedoraproject.org>`_
* New Fedora updates submitted through `bodhi <https://admin.fedoraproject.org/updates>`_
* Updated package repositories for rawhide_ , the current branched_ release (Fedora |next fedora|), and previous Fedora releases.
* Updated installable images of the current branched_ release (Fedora |next fedora|).

Module Documentation
========================================

* :ref:`bodhi_utils <module_bodhi_utils>`

Get Involved
========================================

Just looking?  Follow the links below for general information on the AutoQA project.

* Examine `the current list of tests <http://git.fedorahosted.org/git/?p=autoqa.git;a=tree;f=tests>`_
* Review `the current test events being monitored <http://git.fedorahosted.org/git/?p=autoqa.git;a=tree;f=events>`_
* Review `recent test results <https://fedorahosted.org/pipermail/autoqa-results/{{CURRENTYEAR}}-{{CURRENTMONTHNAME}}/thread.html>`_ or `sign-up for test result notification <http://jlaska.wordpress.com/2010/06/01/fedora-package-maintainers-want-test-results/ sign-up for test result notification>`_

Interested in writing tests?

* Read `Writing AutoQA Tests <https://fedoraproject.org/wiki/Writing_AutoQA_Tests>`_ and `Verifying AutoQA tests <https://fedoraproject.org/wiki/Verifying_AutoQA_tests>`_
* Should your test require a new method to trigger testing, read `Writing AutoQA Events and Watchers <https://fedoraproject.org/wiki/Writing_AutoQA_Events_and_Watchers>`_ *(optional)*
* Integrate your test with AutoQA - `Install and configure AutoQA <https://fedoraproject.org/wiki/Install_and_configure_AutoQA>`_

How about contributing back to the AutoQA project?

* Familiarize yourself with the `architecture overview <https://fedoraproject.org/wiki/AutoQA_architecture>`_ and `development roadmap <https://fedoraproject.org/wiki/AutoQA_Roadmap>`_
* Checkout the code -- `autoqa.git <http://git.fedorahosted.org/git/?p=autoqa.git;a=summary>`_
* AutoQA uses the `Autotest <https://fedoraproject.org/wiki/Autotest>`_ test harness, learn more by visiting `Autotest <https://fedoraproject.org/wiki/Autotest>`_
* AutoQA also has a set of `self tests <https://fedoraproject.org/wiki/AutoQA_Self_Testing>`_ that could always be expanded.

Communicate
========================================

Please contact us!  We look forward to your ideas and suggestions.

* `autoqa-devel <https://fedorahosted.org/mailman/listinfo/autoqa-devel>`_ is the mailing list for development discussion of the AutoQA project
* `autoqa-results <https://fedorahosted.org/mailman/listinfo/autoqa-results>`_ is where automated test results are submitted.  This is intended for test results review only.
* Talk about AutoQA on the permanent QA IRC channel `#fedora-qa <http://webchat.freenode.net/?channels=#fedora-qa>`_
* Visit the project development page at https://fedorahosted.org/autoqa/


.. toctree::
   :maxdepth: 2

Indices and tables
==================

* :ref:`genindex`
* :ref:`modindex`
* :ref:`search`