Date: Fri, 25 Jul 2014 11:19:46 -0700 From: Craig Rodrigues <rodrigc@FreeBSD.org> To: Julio Merino <jmmv@freebsd.org> Cc: "freebsd-testing@freebsd.org" <freebsd-testing@freebsd.org> Subject: Re: Best place to learn how to write tests which work under kyua? Message-ID: <CAG=rPVeS3BRhhzPvwOu_aLKkHZ7D5F%2Br6-U1NTp3Vi%2B=bpxNkw@mail.gmail.com> In-Reply-To: <CAFY7cWDNyujpy3aWxO3F0bE9PwApnvxr3Df7nyVR_ziO6wTOaw@mail.gmail.com> References: <CAG=rPVd8JBGoPg9F%2BwkRZ63m4nKgO-uWybD=hPSpCaPh_ZH3Uw@mail.gmail.com> <CAFY7cWDNyujpy3aWxO3F0bE9PwApnvxr3Df7nyVR_ziO6wTOaw@mail.gmail.com>
next in thread | previous in thread | raw e-mail | index | archive | help
On Thu, Jul 24, 2014 at 1:02 PM, Julio Merino <jmmv@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
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?CAG=rPVeS3BRhhzPvwOu_aLKkHZ7D5F%2Br6-U1NTp3Vi%2B=bpxNkw>