From owner-freebsd-doc@FreeBSD.ORG Mon Jan 28 11:20:36 2013 Return-Path: Delivered-To: doc@FreeBSD.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:1900:2254:206a::19:1]) by hub.freebsd.org (Postfix) with ESMTP id A91D0AEA for ; Mon, 28 Jan 2013 11:20:36 +0000 (UTC) (envelope-from gabor@FreeBSD.org) Received: from server.mypc.hu (server.mypc.hu [87.229.73.95]) by mx1.freebsd.org (Postfix) with ESMTP id 69493FB2 for ; Mon, 28 Jan 2013 11:20:36 +0000 (UTC) Received: from server.mypc.hu (localhost [127.0.0.1]) by server.mypc.hu (Postfix) with ESMTP id CEFA214D2409 for ; Mon, 28 Jan 2013 12:11:56 +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 GgLSgI9eN0xi for ; Mon, 28 Jan 2013 12:11:56 +0100 (CET) Received: from [192.168.1.100] (5403A6BE.catv.pool.telekom.hu [84.3.166.190]) (using TLSv1 with cipher DHE-RSA-CAMELLIA256-SHA (256/256 bits)) (No client certificate requested) by server.mypc.hu (Postfix) with ESMTPSA id 3EB7C14D2401 for ; Mon, 28 Jan 2013 12:11:56 +0100 (CET) Message-ID: <51065CFC.5090803@FreeBSD.org> Date: Mon, 28 Jan 2013 12:11:56 +0100 From: Gabor Kovesdan User-Agent: Mozilla/5.0 (Windows NT 6.1; WOW64; rv:17.0) Gecko/20130107 Thunderbird/17.0.2 MIME-Version: 1.0 To: doc@FreeBSD.org Subject: RFC: Dealing with version-specific docs Content-Type: text/plain; charset=ISO-8859-1; format=flowed Content-Transfer-Encoding: 7bit X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.14 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Mon, 28 Jan 2013 11:20:36 -0000 Hi, as you may know, the printed edition of FreeBSD Handbook is being worked. In our current Handbook version, we have version-specific information for different major releases, while the printed edition shall concentrate on 9.X. We cannot just drop the parts that detail older releases since they haven't yet reached EOL and there are people out there still using these. So we have to deal somehow with this situation. Fortunately, DocBook provides a mechanism, called profiling, which we could use. It would also be beneficial for later cleanup work since finding outdated information that has to do with unsupported releases always requires big effort. I've made a draft about how it could be done in a practical way: https://wiki.freebsd.org/VersionSpecificDocs Please read it and if you have doubts, concerns or better suggestions, please share them. Thanks in advance, Gabor