From owner-freebsd-doc@FreeBSD.ORG Tue Dec 2 12:18:19 2003 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 ACC1516A4CE for ; Tue, 2 Dec 2003 12:18:19 -0800 (PST) Received: from seaholm.caamora.com.au (seaholm.caamora.com.au [203.7.226.5]) by mx1.FreeBSD.org (Postfix) with ESMTP id 66D3E43FBF for ; Tue, 2 Dec 2003 12:18:15 -0800 (PST) (envelope-from jon@seaholm.caamora.com.au) Received: (from jon@localhost) by seaholm.caamora.com.au (8.11.1/8.11.1) id hB2KHWA27826; Wed, 3 Dec 2003 07:17:32 +1100 (EST) Message-ID: <20031203071732.52784@caamora.com.au> Date: Wed, 3 Dec 2003 07:17:32 +1100 From: jonathan michaels To: Bill Moran References: <3FCBB04F.7070204@potentialtech.com> <20031201221825.GB10158@jenny.daemon.li> <3FCBF8E6.6010208@potentialtech.com> <20031202091804.GB269@jenny.daemon.li> <3FCCB644.500@potentialtech.com> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii X-Mailer: Mutt 0.84e In-Reply-To: <3FCCB644.500@potentialtech.com>; from Bill Moran on Tue, Dec 02, 2003 at 10:56:52AM -0500 Organisation: Caamora, PO Box 144, Rosebery NSW 1445 Australia cc: FreeBSD-doc@freebsd.org Subject: Re: Proposed addition to the mail section of the handbook 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: Tue, 02 Dec 2003 20:18:19 -0000 On Tue, Dec 02, 2003 at 10:56:52AM -0500, Bill Moran wrote: > Josef El-Rayes wrote: > > Bill Moran wrote: supportive argument deleted for brevity... > I belive the handbook should have this section. There are many > circumstances where a FreeBSD machine will need to do mail > in a "send-only" capacity. Users should be able to find documentation > on how to make it work. > > You're right, technically, this section should explain how to set > up sendmail to function in this capacity. However, I believe that > sendmail is difficult to properly configure for this use, and > overkill anyway. > > > explaining how to use xyz-MTA for forwarding mails to another ISP > > is not the task of the handbook, this is covered by xyz' docs. > > I worry that this is a case of, "experienced FreeBSD user's can't > understand why documentation this simple is necessary." I feel > that it is necessary. i have been using freebsd since v2.0.5-release and my internetworking backbone stopped at v2.2.7-release and is still running it very reliably (i do see the need to upgrade) i do have significant learning difficulties that keep me glued to teh documentation every time i need to make a change. no matter how minor, how system re-defining. maybe the average new users learning experience is not as acute as mine, or as ongoing as mine, or as long lived it is nonetheless an acute period in thier familiarisation process and it needs to be supported. leaving such documentation out will significantly impact the 'quality of life' and the 'quality of installation and system bedding' this last bit is teh most intense period that most (if not all) newcomers go through on teh way to becoming "experienced FreeBSD user's". it is teh bit that defines who becomes a "experienced FreeBSD user's" and those whole with churn through to teh next cab on teh rank, ummm favourite operating system while the impact may not be immediate it will be profound and leave scars on teh project as a whole for a very very long time. with much thanks to teh existing document manglers for doing a good job in teh face of such resistance. kind regards jonathan -- ================================================================ powered by .. QNX, OS9 and freeBSD -- http://caamora com au/operating system ==== === appropriate solution in an inappropriate world === ====