From owner-freebsd-doc@FreeBSD.ORG Tue May 17 14:35:52 2011 Return-Path: Delivered-To: doc@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id 49B081065676; Tue, 17 May 2011 14:35:52 +0000 (UTC) (envelope-from niclas.zeising@gmail.com) Received: from mail.lysator.liu.se (unknown [IPv6:2001:6b0:17:f0a0::3]) by mx1.freebsd.org (Postfix) with ESMTP id 01B128FC16; Tue, 17 May 2011 14:35:52 +0000 (UTC) Received: from mail.lysator.liu.se (localhost [127.0.0.1]) by mail.lysator.liu.se (Postfix) with ESMTP id 52BCF40023; Tue, 17 May 2011 16:35:51 +0200 (CEST) Received: by mail.lysator.liu.se (Postfix, from userid 1004) id 48AC840026; Tue, 17 May 2011 16:35:51 +0200 (CEST) X-Spam-Checker-Version: SpamAssassin 3.3.1 (2010-03-16) on bernadotte.lysator.liu.se X-Spam-Level: X-Spam-Status: No, score=-0.2 required=5.0 tests=AWL,FREEMAIL_FROM autolearn=disabled version=3.3.1 X-Spam-Score: -0.2 Received: from mx.daemonic.se (h-90-99.A163.priv.bahnhof.se [79.136.90.99]) (using TLSv1 with cipher DHE-RSA-AES256-SHA (256/256 bits)) (No client certificate requested) by mail.lysator.liu.se (Postfix) with ESMTPSA id 0FB9D40023; Tue, 17 May 2011 16:35:51 +0200 (CEST) Received: from mail.daemonic.se (mail.daemonic.se [IPv6:2001:470:dca9:0:1::4]) by mx.daemonic.se (Postfix) with ESMTPS id DB769119C04; Tue, 17 May 2011 16:35:50 +0200 (CEST) Received: from [IPv6:2001:470:dca9:1::4] (vivi.daemonic.se [IPv6:2001:470:dca9:1::4]) by mail.daemonic.se (Postfix) with ESMTPSA id C4A2012B2DA; Tue, 17 May 2011 16:35:50 +0200 (CEST) Message-ID: <4DD287C5.4020806@gmail.com> Date: Tue, 17 May 2011 16:35:49 +0200 From: Niclas Zeising User-Agent: Mutt/1.5.21 MIME-Version: 1.0 To: Glen Barber References: <4DD267A5.6050203@gmail.com> <4DD28554.8010203@FreeBSD.org> In-Reply-To: <4DD28554.8010203@FreeBSD.org> Content-Type: text/plain; charset=ISO-8859-1 Content-Transfer-Encoding: 7bit X-Virus-Scanned: ClamAV using ClamSMTP Cc: doc@freebsd.org Subject: Re: Sections about ports software in handbook X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Tue, 17 May 2011 14:35:52 -0000 On 2011-05-17 16:25, Glen Barber wrote: > On 5/17/11 8:18 AM, Niclas Zeising wrote: >> Hi! > > Hi Niclas, > >> Is there any interest in having sections in the handbook about >> configuring various ports software suites? I was thinking about >> additions for postfix, imap/pop3 servers, maybe nagios, and similar >> often very much used applications. >> The idea is to add sections about simple configurations, and then refer >> to other documentation for complex setups. >> >> Is this welcome, or would patches to this effect be mostly a waste of >> time? What do you think? >> > > I don't speak for anyone else but myself (and certainly do not oppose > this idea), however I think doing this might add redundant information > to the Handbook, meaning, configurations that have already been > documented by the respective software vendor. I know the documentation will be redundant, since, as you say, it's already documented. This is my main argument against doing this as well. On the other hand, having basic documentation of this kind in the handbook can possibly help users/admins with the setup, without the need for more advanced setup, which still will be on the vendor site. For instance, this is already done for apache. > > Maybe this type of documentation would be better in separate articles > (or better off, maybe the Wiki) for FreeBSD-specific configurations > where the vendor's defaults "don't quite work", rather than general > How-To configurations. > > Best regards, > This might be an idea as well, allthough I don't know how much exposure the wiki gets. Regards -- Niclas