From mboxrd@z Thu Jan 1 00:00:00 1970 Received: from eggs.gnu.org ([2001:4830:134:3::10]:55308) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1gMa2q-0006k2-UD for qemu-devel@nongnu.org; Tue, 13 Nov 2018 09:52:04 -0500 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1gMa2p-0006qE-Ut for qemu-devel@nongnu.org; Tue, 13 Nov 2018 09:52:00 -0500 Date: Tue, 13 Nov 2018 12:51:12 -0200 From: Eduardo Habkost Message-ID: <20181113145112.GL12503@habkost.net> References: <20181112104953.GB11580@linux.fritz.box> <20181112160025.GE11580@linux.fritz.box> <20181113121836.GC4830@localhost.localdomain> <20181113132653.GG12503@habkost.net> <20181113135116.GE4830@localhost.localdomain> <20181113143223.GK12503@habkost.net> <88fd00ad-fef7-6233-c458-bc9c712e510b@redhat.com> MIME-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline In-Reply-To: <88fd00ad-fef7-6233-c458-bc9c712e510b@redhat.com> Subject: Re: [Qemu-devel] [RFC PATCH 0/2] Acceptance tests for qemu-img List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , To: Cleber Rosa Cc: Kevin Wolf , qemu-block@nongnu.org, qemu-devel@nongnu.org, Max Reitz , Wainer dos Santos Moschetta , Caio Carrara , Philippe =?iso-8859-1?Q?Mathieu-Daud=E9?= On Tue, Nov 13, 2018 at 09:43:49AM -0500, Cleber Rosa wrote: > > On 11/13/18 9:32 AM, Eduardo Habkost wrote: > > On Tue, Nov 13, 2018 at 09:20:11AM -0500, Cleber Rosa wrote: > > > > With check-venv, we made "installing avocado" a small > > implementation detail that people don't need to care about when > > running the tests. > > > > I believe the sentence "which must be installed separately" is > > now confusing and misleading. It can be easily interpreted as > > "must be installed manually by the user", which is not case. > > > > Yeah, it can be confusing. Maybe something like: > > These tests are written using the Avocado Testing Framework (which must > either be manually installed, or automatically as part of ``make > check-acceptance``)... If it doesn't require any action from the user, why bother mentioning it at the beginning of the document? Avocado installation can be a small footnote below the "running tests" section, for people interested in implementation details. -- Eduardo