From owner-freebsd-testing@FreeBSD.ORG Fri Jul 25 18:19:49 2014 Return-Path: Delivered-To: freebsd-testing@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:1900:2254:206a::19:1]) (using TLSv1 with cipher ADH-AES256-SHA (256/256 bits)) (No client certificate requested) by hub.freebsd.org (Postfix) with ESMTPS id 3F107D77; Fri, 25 Jul 2014 18:19:49 +0000 (UTC) Received: from mail-lb0-x236.google.com (mail-lb0-x236.google.com [IPv6:2a00:1450:4010:c04::236]) (using TLSv1 with cipher ECDHE-RSA-RC4-SHA (128/128 bits)) (Client CN "smtp.gmail.com", Issuer "Google Internet Authority G2" (verified OK)) by mx1.freebsd.org (Postfix) with ESMTPS id 8EA552E01; Fri, 25 Jul 2014 18:19:48 +0000 (UTC) Received: by mail-lb0-f182.google.com with SMTP id z11so3751627lbi.27 for ; Fri, 25 Jul 2014 11:19:46 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20120113; h=mime-version:sender:in-reply-to:references:date:message-id:subject :from:to:cc:content-type; bh=AW61YW3Sh75OqLO7AtgyzmlF9F8rXa3Ml4z3yhfgUrQ=; b=07XwyARG08qDgFdDDpsfVuOhtMFa/M73tUd+KIU9QQg9pbhnaLwI6RDj0JBnC7ZKJg OAZRqmBLuryNuweOtHF+kNzvUXgEVLOsvIY8Ftr+hbIAdfy2ikA6v/Uj5xwRtBR0WI6I HOBP3cNsE7+z00dDNLr/2XAKIl2JVVv39kOzv4jM7b5bCHiGCKrsyv3x0hAgpGspbDfg xdLY6zBOQbR04RJkf2foCQRfBp3SqAkpjq5bdok2f9EWY4A7SU4JazG55L+ZU+vefvG0 FDp6+OQeZzv1fjzbwuh0rwYpaS3DYtftSv9FZrbv5Q9heF+zhF+7baogCJ2/JpyI8+Cj flhg== MIME-Version: 1.0 X-Received: by 10.152.36.135 with SMTP id q7mr13938857laj.42.1406312386507; Fri, 25 Jul 2014 11:19:46 -0700 (PDT) Sender: crodr001@gmail.com Received: by 10.112.225.34 with HTTP; Fri, 25 Jul 2014 11:19:46 -0700 (PDT) In-Reply-To: References: Date: Fri, 25 Jul 2014 11:19:46 -0700 X-Google-Sender-Auth: lgoCrPEUBVwe-LYDVp0KW0p4zmQ Message-ID: Subject: Re: Best place to learn how to write tests which work under kyua? From: Craig Rodrigues To: Julio Merino Content-Type: text/plain; charset=ISO-8859-1 X-Content-Filtered-By: Mailman/MimeDel 2.1.18 Cc: "freebsd-testing@freebsd.org" X-BeenThere: freebsd-testing@freebsd.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: Testing on FreeBSD List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Fri, 25 Jul 2014 18:19:49 -0000 On Thu, Jul 24, 2014 at 1:02 PM, Julio Merino 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