From owner-freebsd-doc@FreeBSD.ORG Mon Jan 28 13:14:50 2013 Return-Path: Delivered-To: doc@freebsd.org Received: from mx1.freebsd.org (mx1.FreeBSD.org [8.8.178.115]) by hub.freebsd.org (Postfix) with ESMTP id 4CD5019E; Mon, 28 Jan 2013 13:14:50 +0000 (UTC) (envelope-from m.e.sanliturk@gmail.com) Received: from mail-ia0-x22b.google.com (mail-ia0-x22b.google.com [IPv6:2607:f8b0:4001:c02::22b]) by mx1.freebsd.org (Postfix) with ESMTP id E21FE9D7; Mon, 28 Jan 2013 13:14:49 +0000 (UTC) Received: by mail-ia0-f171.google.com with SMTP id z13so4177114iaz.30 for ; Mon, 28 Jan 2013 05:14:49 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20120113; h=mime-version:x-received:in-reply-to:references:date:message-id :subject:from:to:cc:content-type; bh=onHFWNI3smN4w7b/cVdb9nkDj6ovXz1zH3/DVv4rSO8=; b=vagjDjypMAZ1eOa+QLtu6Kcpbx/qlO+1IzPj2yjFNTP0p1qti1UWRV9BlrbBTS4LeE KcJtki6ZS/PfEfBY4yDSt/WMRcVNEWfVdubQTRQ0Vgv7R1kKtmrKHufIm3fdmv+4kuYq Z4t9ggrUyBVJXPz2HBBVSo5YXFmNch5GWzStKjHlUxobrIZPWi0cvAwQCNDA97Gzlpc8 e5S3LHXgQU0CxlzX4bLC3njDfbcYFtITbEnhqPHp34DcOCN5GFDK+6gdPfxadiNlOo1f +Q9ByWB+yM+urFyKXYs42RIvas4jwhHSnR9qDZYYB7ii4B/RHrTshBLciisQTv9dBEKl DysQ== MIME-Version: 1.0 X-Received: by 10.50.57.234 with SMTP id l10mr4913768igq.18.1359378888921; Mon, 28 Jan 2013 05:14:48 -0800 (PST) Received: by 10.42.118.70 with HTTP; Mon, 28 Jan 2013 05:14:48 -0800 (PST) In-Reply-To: <51067472.5000902@FreeBSD.org> References: <51065CFC.5090803@FreeBSD.org> <51067472.5000902@FreeBSD.org> Date: Mon, 28 Jan 2013 05:14:48 -0800 Message-ID: Subject: Re: RFC: Dealing with version-specific docs From: Mehmet Erol Sanliturk To: Gabor Kovesdan Content-Type: text/plain; charset=UTF-8 X-Content-Filtered-By: Mailman/MimeDel 2.1.14 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 13:14:50 -0000 On Mon, Jan 28, 2013 at 4:52 AM, Gabor Kovesdan wrote: > 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 > I am very sorry about not being on subject . Thank you very much . Mehmet Erol Sanliturk