Best place to learn how to write tests which work under kyua?

[Craig Rodrigues]

On Thu, Jul 24, 2014 at 1:02 PM, Julio Merino <jmmv at freebsd.org> wrote:

> I thought I had something in the Kyua wiki pages, but I guess not.
> Meh, I'll have to write some other kind of documentation or
> introductory article... documentation is currently not very good, I
> agree.
>
> What kind of text would help you most? A step-by-step tutorial maybe?
> Big parts of the process may be tied to the build system you use
> though, and I only know the BSD build systems and Automake/autoconf...
>


A step-by-step tutorial would be a good start.
The wiki pages that are available now, do not give a good idea
of even how to get started with writing Kyua-compatible tests.

For example, if I was working in a company where I had to point
a QA team to some docs so that they could write Kyua-compatible
tests for a software product, there is nothing I can point them to now.

It's great that there are examples in the FreeBSD src tree
(which is what I started looking at to understand how things work), but
Kyua should be able to stand on its own, without FreeBSD.

I'm neutral on whether the docs should live in the FreeBSD handbook
or elsewhere.  There are pros and cons for each approach.
--
Craig