From owner-freebsd-doc@FreeBSD.ORG Tue Feb 4 09:10:34 2014 Return-Path: Delivered-To: freebsd-doc@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [8.8.178.115]) (using TLSv1 with cipher ADH-AES256-SHA (256/256 bits)) (No client certificate requested) by hub.freebsd.org (Postfix) with ESMTPS id E9F63902; Tue, 4 Feb 2014 09:10:34 +0000 (UTC) Received: from server.mypc.hu (server.mypc.hu [87.229.73.95]) (using TLSv1 with cipher ADH-CAMELLIA256-SHA (256/256 bits)) (No client certificate requested) by mx1.freebsd.org (Postfix) with ESMTPS id 9B72814E5; Tue, 4 Feb 2014 09:10:33 +0000 (UTC) Received: from server.mypc.hu (localhost [127.0.0.1]) by server.mypc.hu (Postfix) with ESMTP id 6017814D2537; Tue, 4 Feb 2014 10:10:17 +0100 (CET) X-Virus-Scanned: amavisd-new at !change-mydomain-variable!.example.com Received: from server.mypc.hu ([127.0.0.1]) by server.mypc.hu (server.mypc.hu [127.0.0.1]) (amavisd-new, port 10024) with LMTP id 2N0qLzPZ67Wq; Tue, 4 Feb 2014 10:10:16 +0100 (CET) Received: from [192.168.0.10] (54034B4D.catv.pool.telekom.hu [84.3.75.77]) (using TLSv1 with cipher DHE-RSA-CAMELLIA256-SHA (256/256 bits)) (No client certificate requested) by server.mypc.hu (Postfix) with ESMTPSA id D0E0F14D2536; Tue, 4 Feb 2014 10:10:16 +0100 (CET) Message-ID: <52F0AE74.4090502@kovesdan.org> Date: Tue, 04 Feb 2014 10:10:12 +0100 From: =?ISO-8859-1?Q?G=E1bor_K=F6vesd=E1n?= User-Agent: Mozilla/5.0 (Windows NT 6.1; WOW64; rv:17.0) Gecko/20130801 Thunderbird/17.0.8 MIME-Version: 1.0 To: Warren Block Subject: Re: updating documentation set References: <1391476740.64494.YahooMailNeo@web184904.mail.gq1.yahoo.com> In-Reply-To: Content-Type: text/plain; charset=ISO-8859-1; format=flowed Content-Transfer-Encoding: 7bit Cc: Dru Lavigne , "freebsd-doc@freebsd.org" X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.17 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Tue, 04 Feb 2014 09:10:35 -0000 On 2014.02.04. 4:01, Warren Block wrote: > On Mon, 3 Feb 2014, Dru Lavigne wrote: > >> This section: >> >> 23.4. Updating the Documentation Set >> >> really belongs (and is already mostly duplicated in): >> >> http://www.freebsd.org/doc/en_US.ISO8859-1/books/fdp-primer/overview.html#overview-doc >> >> >> Any objections to me doing the following? >> >> 1. remove "23.4. Updating the Documentation Set" from the Handbook, >> replacing it with a NOTE in the updating section that docs can either >> be updated during an OS upgrade or, at any other time, by following >> the instructions in the FDP overview (with link) >> >> >> 2. make sure that any points covered by 23.4 and currently missing >> from the FDP overview are added to the FDP overview > > Don't we have doc ports specifically for users to keep a current > version of the documentation on their system? Upgrading a port is > simpler for an end user than an svn checkout, there's less overhead, > and we would not have to expose them to developer instructions. I also think that should be still documented in the Handbook. It is a relevant information from an end-user perspective how to obtain the already rendered versions of other kind of documentation. And imo, it should be treated in the introduction or somewhere in the beginning. Gabor