From owner-freebsd-doc@FreeBSD.ORG Mon Jan 28 12:52:07 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 C51E0459 for ; Mon, 28 Jan 2013 12:52:07 +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 85A1E852 for ; Mon, 28 Jan 2013 12:52:07 +0000 (UTC) Received: from server.mypc.hu (localhost [127.0.0.1]) by server.mypc.hu (Postfix) with ESMTP id 5B34114D2402; Mon, 28 Jan 2013 13:52:06 +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 0ObVuwsWMZRE; Mon, 28 Jan 2013 13:52:01 +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 9FDA114D2401; Mon, 28 Jan 2013 13:52:01 +0100 (CET) Message-ID: <51067472.5000902@FreeBSD.org> Date: Mon, 28 Jan 2013 13:52:02 +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: Mehmet Erol Sanliturk Subject: Re: RFC: Dealing with version-specific docs References: <51065CFC.5090803@FreeBSD.org> In-Reply-To: Content-Type: text/plain; charset=UTF-8; format=flowed Content-Transfer-Encoding: 7bit Cc: doc@freebsd.org 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 12:52:07 -0000 Em 28-01-2013 13:15, Mehmet Erol Sanliturk escreveu: > I think , the required effort for version specific Handbook is much > less than multiple version covering Handbook , because , if any change > is not applied to a prior version , which is mostly the case , > its Handbook will also not be modified . > If a change is applied to a version and it is copied also to prior > versions , the changes to the Handbook may also be copied to their > Handbooks . This will not be difficult than to modify a multiple > version contained Handbook . > > As a result , again my primary suggestion is to make the Handbook > version specific : When a version is branched , its Handbook and > related other documentation also should be branched and maintained > with the related version . Mehmet, thanks for the comments but I was interested in comments of that very specific technical solution that I proposed on the linked wiki page. The necessity of handling version-specific information has been discussed several times both on the lists and on conferences so please let's focus on technical solutions rather than going back to general discussions. If you see the linked page, there was no branching mentioned there, it is a much easier and simpler approach. Gabor