From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from merlin.infradead.org ([205.233.59.134]:58243 "EHLO merlin.infradead.org" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1756989Ab3IDO0O (ORCPT ); Wed, 4 Sep 2013 10:26:14 -0400 Message-ID: <52274302.6050407@kernel.dk> Date: Wed, 04 Sep 2013 08:26:10 -0600 From: Jens Axboe MIME-Version: 1.0 Subject: Re: [PATCH] Rework descriptions for mailing list, options, job files References: <1378253081-28050-1-git-send-email-grundler@chromium.org> In-Reply-To: <1378253081-28050-1-git-send-email-grundler@chromium.org> Content-Type: text/plain; charset=ISO-8859-1 Content-Transfer-Encoding: 7bit Sender: fio-owner@vger.kernel.org List-Id: fio@vger.kernel.org To: Grant Grundler Cc: Juan Casse , fio@vger.kernel.org On 09/03/2013 06:04 PM, Grant Grundler wrote: > In general, make the existing document less ambiguous: > o Use consistent formatting/layout when describing options > o always refer to options with "--" prefix. > o reduce use of pronouns: "its" and "this" are often ambigous. > o remove use of "you" to describe user actions/choices > o add reference to examples/ directory Thanks! -- Jens Axboe