openqa/webui repository overview

:travis-ci: image:https://api.travis-ci.org/os-autoinst/openQA.svg?branch=master[link=https://travis-ci.org/os-autoinst/openQA⁠] :codecov: image:https://codecov.io/gh/os-autoinst/openQA/branch/master/graph/badge.svg[link=https://codecov.io/gh/os-autoinst/openQA⁠]

= openQA

{codecov} {travis-ci}

openQA is a testing framework that allows you to test GUI applications on one hand and bootloader and kernel on the other. In both cases, it is difficult to script tests and verify the output. Output can be a popup window or it can be an error in early boot even before init is executed.

Therefore openQA runs virtual machines and closely monitors their state and runs tests on them.

The testing framework can be divided in two parts. The one that is hosted in this repository contains the web frontend and management logic (test scheduling, management, high-level API, ...)

The other part that you need to run openQA is the OS-autoinst test engine that is hosted in a separate https://github.com/os-autoinst/os-autoinst[repository⁠].

== Getting started

The project's information is organized into four basic documents. As a first step, read the link:docs/GettingStarted.asciidoc[Starter Guide] and then, if needed, proceed to the link:docs/Installing.asciidoc[Installation Guide].

For users of the openQA web interface or the REST API consult link:docs/UsersGuide.asciidoc[Users Guide].

If you are interested in writing tests using openQA read the link:docs/WritingTests.asciidoc[Tests Developer Guide].

== Contributing [id="getting_involved"]

If you are interested in contributing to openQA itself, check the link:docs/Contributing.asciidoc[Developer Guide], write your code and send a pull request ;-)

=== Issue trackers and support :openqav3: https://progress.opensuse.org/projects/openqav3[openQAv3⁠ project]

Our main issue tracker is at {openqav3} in openSUSE's project management tool. This Redmine instance is used to coordinate the main development effort organizing the existing issues (bugs and desired features) into 'target versions'.

Currently developers meet in IRC channel irc://chat.freenode.net/opensuse-factory[#opensuse-factory]