[[!meta title="Subplot"]]

[[Download]] —
[[Documentation|docs]] —
[[Contact]] —
[[License]] —
[[Blog]]

[[!img kitten.jpg class=float_right
   alt="Kitten being adorable. By Ckahler on English Wikipedia"]]

## When all stakeholders really need to understand acceptance criteria

Capture and communicate acceptance criteria for software and systems,
and how they are verified, in a way that's understood by all project
stakeholders.

Subplot is a set of tools for specifying, documenting, and
implementing automated acceptance tests for systems and software.
Subplot tools help produce a human-readable document of acceptance
criteria and a program that automatically tests a system against those
criteria.

Subplot is currently in its ALPHA stage.

## Participate

Subplot is a community project: it is developed by some people who
want to do it. You could help!

* [[Governance]] model
* [[Code of conduct|conduct]]
* [[Architecture]]
* [[Road map|roadmap]]
* [[Definition of success|success]]
* [[Contributing]] to the project
* [[Contact]] the project

Please note that this project is released with a [[Contributor Code of
Conduct|conduct]]. By participating in this project you agree
to abide by its terms.

## Examples

See actual, working, tested examples:

* The Unix echo command
  ([html](https://examples.subplot.liw.fi/echo.html),
  [PDF](https://examples.subplot.liw.fi/echo.pdf)).

* A hypothetical JSON store with access control and a web API
  ([html](https://examples.subplot.liw.fi/muck.html),
  [PDF](https://examples.subplot.liw.fi/muck.pdf)).

* Subplot's own acceptance criteria, a non-trivial example
  ([html](https://examples.subplot.liw.fi/subplot.html)
  [PDF](https://examples.subplot.liw.fi/subplot.pdf)) .

The [examples][] site may have more examples, if we forget to list
them here. These are generated automatically from the Subplot source
repository by CI, so they're always up to date, and tested as part of
Subplot's CI build, so they always work.

[examples]: https://examples.subplot.liw.fi/

## Latest from the project

<div class="newslist">
[[!inline pages="page(blog/*)" 
  limit=5 template=titlepage archive=yes trail=no feeds=no]]
</div>