From owner-freebsd-questions@FreeBSD.ORG Sat Aug 27 18:56:18 2011 Return-Path: Delivered-To: freebsd-questions@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id B4E981065670 for ; Sat, 27 Aug 2011 18:56:18 +0000 (UTC) (envelope-from antiequality@gmail.com) Received: from mail-ww0-f50.google.com (mail-ww0-f50.google.com [74.125.82.50]) by mx1.freebsd.org (Postfix) with ESMTP id 463F08FC08 for ; Sat, 27 Aug 2011 18:56:17 +0000 (UTC) Received: by wwi36 with SMTP id 36so4529735wwi.31 for ; Sat, 27 Aug 2011 11:56:17 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=gamma; h=mime-version:in-reply-to:references:date:message-id:subject:from:to :content-type; bh=4VBpKMA/Bf6BSV51HjWSpGzuwiMNppABKkFEJjokWgc=; b=GqMDQqYS+GIJW1b+OeAoNhNnItRMKMKjan2ZpyBb3YmAzIWDOMpPqjdbdGsF58pV+0 pX5v55JlI4WVPkQLbGZy24LRVOTSK4qGt4wfdHYUIjQD6NQsA2++qw9lxpQZ+64BsoZr 5eLBsi0JsuiUZ2AVZ5ewRShvDeKVX1q39caFw= MIME-Version: 1.0 Received: by 10.216.171.200 with SMTP id r50mr2029344wel.90.1314471377113; Sat, 27 Aug 2011 11:56:17 -0700 (PDT) Received: by 10.216.66.201 with HTTP; Sat, 27 Aug 2011 11:56:16 -0700 (PDT) In-Reply-To: <20110825043208.fe201707.freebsd@edvax.de> References: <16851_1313817220_4E4F4284_16851_6517_1_D9B37353831173459FDAA836D3B43499C521886E@WADPMBXV0.waddell.com> <20110825043208.fe201707.freebsd@edvax.de> Date: Sat, 27 Aug 2011 13:56:16 -0500 Message-ID: From: Evan Busch To: "freebsd-questions@freebsd.org" Content-Type: text/plain; charset=ISO-8859-1 Subject: Re: A quality operating system X-BeenThere: freebsd-questions@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: User questions List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Sat, 27 Aug 2011 18:56:18 -0000 I can see this will be important here: http://en.wikipedia.org/wiki/False_dilemma On Wed, Aug 24, 2011 at 9:32 PM, Polytropon wrote: > But allow me to say > that _if_ you are interested in contributing in _that_ > way, you should always bring examples and name _concrete_ > points you're criticizing, instead of just mentioning > wide ranges of "this doesn't conform to my interpretation > of what 'professional' should look like". The problem with your statement is that it does not allow for general critique, which is also needed. If something shows up in more than one place, it is a general critique. > In most cases, documentation requires you to have a minimal > clue of what you're doing. There's terminology you simply > have to know, and concepts to understand in order to use > the documentation. See the Wikipedia page above -- the problem isn't one of user competence, but of poorly-written documentation that is fundamentally disorganized. Have you looked at any of the documentation coming out of Redmond right now? How do you think FreeBSD's documentation stands up to that? > Different kinds of users have different preferences. Some > like to use the web, like to use Wikis and discussion boards. > Others like to use structured web pages. Again, other like > web pages too, but want to have as much information in _one_ > (long) page. And there are those who do not want to depend > on the web - those like man pages. The question isn't form, but content. > If you're used to some specific _way_ of documentation, you > will maybe value anything that's _different_ from that way > as being inferior, non-professional, or less helpful. I think I'm talking about professional level documentation, not a specific "style." > Also keep in mind that especially for developers, the SOURCE > CODE also is an important piece of documentation. Here FreeBSD > is very good, compared to other systems. We're talking end-user documentation here. > Here the "one size fits all" problem arises. It's really hard > to make documentation "for everybody". I disagree. It's very clear what must be done because multiple archetypes exist. > Note the presence of ":-)" and the abilities of english native > speakers who are much more able to express "between the lines" > than I am, for example. If so, it's just them trying to cover up the inherently defensive and reactionary nature of their comments. Would they send such an email on a business list? > You can "predict" that everywhere. Just go to any halfway > specialized setting and make claims about something not > meeting your requirements I've never had this problem when the claims have been stated professionally -- only here.