From owner-freebsd-doc@FreeBSD.ORG  Sat Jun 23 22:05:03 2012
Return-Path: <owner-freebsd-doc@FreeBSD.ORG>
Delivered-To: doc@freebsd.org
Received: from mx1.freebsd.org (mx1.freebsd.org [69.147.83.52])
	by hub.freebsd.org (Postfix) with ESMTP id 27F4B1065670;
	Sat, 23 Jun 2012 22:05:03 +0000 (UTC)
	(envelope-from wblock@wonkity.com)
Received: from wonkity.com (wonkity.com [67.158.26.137])
	by mx1.freebsd.org (Postfix) with ESMTP id D563A8FC08;
	Sat, 23 Jun 2012 22:05:02 +0000 (UTC)
Received: from wonkity.com (localhost [127.0.0.1])
	by wonkity.com (8.14.5/8.14.5) with ESMTP id q5NM52vf087736;
	Sat, 23 Jun 2012 16:05:02 -0600 (MDT)
	(envelope-from wblock@wonkity.com)
Received: from localhost (wblock@localhost)
	by wonkity.com (8.14.5/8.14.5/Submit) with ESMTP id q5NM529Q087733;
	Sat, 23 Jun 2012 16:05:02 -0600 (MDT)
	(envelope-from wblock@wonkity.com)
Date: Sat, 23 Jun 2012 16:05:01 -0600 (MDT)
From: Warren Block <wblock@wonkity.com>
To: Gabor Kovesdan <gabor@freebsd.org>
In-Reply-To: <4FE368F6.4030805@FreeBSD.org>
Message-ID: <alpine.BSF.2.00.1206231602100.87600@wonkity.com>
References: <4FE368F6.4030805@FreeBSD.org>
User-Agent: Alpine 2.00 (BSF 1167 2008-08-23)
MIME-Version: 1.0
Content-Type: TEXT/PLAIN; charset=US-ASCII; format=flowed
X-Greylist: Sender IP whitelisted, not delayed by milter-greylist-4.2.7
	(wonkity.com [127.0.0.1]); Sat, 23 Jun 2012 16:05:02 -0600 (MDT)
Cc: doc@freebsd.org
Subject: Re: [HEADS UP] XML migration and opening of projects/
X-BeenThere: freebsd-doc@freebsd.org
X-Mailman-Version: 2.1.5
Precedence: list
List-Id: Documentation project <freebsd-doc.freebsd.org>
List-Unsubscribe: <http://lists.freebsd.org/mailman/listinfo/freebsd-doc>,
	<mailto:freebsd-doc-request@freebsd.org?subject=unsubscribe>
List-Archive: <http://lists.freebsd.org/pipermail/freebsd-doc>
List-Post: <mailto:freebsd-doc@freebsd.org>
List-Help: <mailto:freebsd-doc-request@freebsd.org?subject=help>
List-Subscribe: <http://lists.freebsd.org/mailman/listinfo/freebsd-doc>,
	<mailto:freebsd-doc-request@freebsd.org?subject=subscribe>
X-List-Received-Date: Sat, 23 Jun 2012 22:05:03 -0000

On Thu, 21 Jun 2012, Gabor Kovesdan wrote:

> the migration to SVN and the related reorganization seem to have gone
> seamlessly. However, the planned doc infrastructure improvements are not
> finished yet. The next item on our TODO list is the long overdue XML
> migration. Now we have a proper VCS system that supports renames and
> moves in the tree so we can follow up with bigger reorganizations.
> (Side note: do not be afraid of the changes, authoring will not be more
> complicated at all.)
>
> This XML migration is quite a complex reorganization and as such, it
> cannot be done on the mainline of doc development so we decided to do it
> in a separate branch. Also, this project will be the first
> experiment on branching and merging back changes to head. To open
> projects/ for the public we have to carefully evaluate the potential
> scenarios of merging and choose that one that best suites our
> development model. We at doceng will work out a draft about using
> projects/ and merging changes back to head. We will post this to doc@
> and once the policies and best practices are established, finally
> projects/ will be open for the big public.
>
> You can expect to see our draft policies in 2-3 weeks, so projects/ may
> be open around mid-July.

How automated is the conversion?  Put another way: should we delay major 
whitespace or content commits to existing SGML documents?