From owner-freebsd-doc@FreeBSD.ORG Sun Dec 12 17:03:41 2004 Return-Path: Delivered-To: freebsd-doc@freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 694BC16A4CE; Sun, 12 Dec 2004 17:03:41 +0000 (GMT) Received: from mail.elvandar.org (redqueen.elvandar.org [217.148.169.55]) by mx1.FreeBSD.org (Postfix) with ESMTP id 2EECC43D1F; Sun, 12 Dec 2004 17:03:41 +0000 (GMT) (envelope-from remko@elvandar.org) Received: from localhost (localhost [127.0.0.1]) by mail.elvandar.org (Postfix) with ESMTP id 3A50429542D; Sun, 12 Dec 2004 18:03:40 +0100 (CET) Received: from mail.elvandar.org ([127.0.0.1]) by localhost (redqueen.elvandar.org [127.0.0.1]) (amavisd-new, port 10024) with ESMTP id 28426-08; Sun, 12 Dec 2004 18:03:39 +0100 (CET) In-Reply-To: <20041211145337.GC34046@clan.nothing-going-on.org> References: <20041211145337.GC34046@clan.nothing-going-on.org> Mime-Version: 1.0 (Apple Message framework v619) Content-Type: text/plain; charset=US-ASCII; format=flowed Message-Id: Content-Transfer-Encoding: 7bit From: Remko Lodder Date: Sun, 12 Dec 2004 18:03:37 +0100 To: Nik Clayton X-Mailer: Apple Mail (2.619) X-Virus-Scanned: amavisd-new at elvandar.org cc: doc@freebsd.org Subject: Re: Kwalitee X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Sun, 12 Dec 2004 17:03:41 -0000 On Dec 11, 2004, at 3:53 PM, Nik Clayton wrote: > Thinking out loud. Hey Nik, So you were that noise? :) > > One of the things we strive for is to improve the quality of our > documentation. Great! I think the metrics etc that are given by you apply to most of our documentation. > > Thoughts? What other metrics can people come up with? Remember, it > needs to be possible to objectively test them. 1) Perhaps a metric about how many 's there are in a file. If there are more then 10(?) then it might be worth looking into the document why it is quoted that much. Perhaps its right but perhaps the text should be reworded so that the need for quotes vanishes. 2) How is the style of the document? If the style is rather bad (like the layout of some of our current chapters) it might be that it means work in progress and needs looking after by some people to trace bugs and other faults. We can measure that by just looking into the document. If i think of more, i will ofcourse reply again :) Cheers!! > > N > -- > FreeBSD: The Power to Serve http://www.freebsd.org/ > (__) > FreeBSD Documentation Project http://www.freebsd.org/docproj/ > \\\'',) > > \/ \ ^ > --- 15B8 3FFC DDB4 34B0 AA5F 94B7 93A8 0764 2C37 E375 --- > .\._/_) > Kind regards, Remko Lodder FreeBSD (Dutch) Documentation team