The new task docs in Beaker 0.13 are in improvement, but are still missing an overview of the required contents of a beah task. The example relies on beaker-wizard to generate the skeleton, while the task metadata section runs through some expected variables in the Makefile and testinfo.desc without actually summarising the expected files anywhere.
We need a "Structure of a beah task" section which:
1. Explains the required files
2. Explains the general concepts involved in result reporting and log uploading
3. Makes it clear that tasks are assumed to fail by default, *unless* a positive result is reported (and rhts-run-simple-command is an easier way to do that)
This section would reference other sections for details where appropriate.
+++ This bug was initially created as a clone of Bug #980423 +++