From owner-freebsd-doc Mon Mar 12 17:55:52 2001 Delivered-To: freebsd-doc@freebsd.org Received: from mta5.rcsntx.swbell.net (mta5.rcsntx.swbell.net [151.164.30.29]) by hub.freebsd.org (Postfix) with ESMTP id 11E5437B718; Mon, 12 Mar 2001 17:55:49 -0800 (PST) (envelope-from chris@holly.calldei.com) Received: from holly.calldei.com ([208.191.149.190]) by mta5.rcsntx.swbell.net (Sun Internet Mail Server sims.3.5.2000.01.05.12.18.p9) with ESMTP id <0GA400BEG4L1BB@mta5.rcsntx.swbell.net>; Mon, 12 Mar 2001 19:39:02 -0600 (CST) Received: (from chris@localhost) by holly.calldei.com (8.11.1/8.9.3) id f2D1fH253006; Mon, 12 Mar 2001 19:41:17 -0600 (CST envelope-from chris) Date: Mon, 12 Mar 2001 19:39:56 -0600 From: Chris Costello Subject: Re: Translators: Need feedback on FAQ reorganization In-reply-to: ; from jhb@FreeBSD.org on Mon, Mar 12, 2001 at 03:37:31PM -0800 To: John Baldwin Cc: Nik Clayton , doc@FreeBSD.org, Udo Erdelhoff Reply-To: chris@calldei.com Message-id: <20010312193955.A52419@holly.calldei.com> MIME-version: 1.0 Content-type: text/plain; charset=us-ascii Content-disposition: inline User-Agent: Mutt/1.2.5i References: <20010312231347.B75170@canyon.nothing-going-on.org> Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org On Monday, March 12, 2001, John Baldwin wrote: > Err, he's just changing the layout in SGML for the first step, it should have > zero effect on what the FAQ looks like once it is formatted. This allows all > the translators to know where to split it up into their respective individual > files. Once the actual split up is done, each of the chapters can be committed > to with the normal rules. Think of the faq.sgml split up as a bunch of > whitespace commits. Glad I didn't have to follow up to each of your replies to one another; this sums it up nicely. I can start over with the new FAQ work. That's not a problem, when you really think about the amount of work involved. It's mostly caring enough and having the patience to deal with Norm's Spawn (modifications by Nik Clayton et. al.) known as DocBook. So far, from all the feedback, I think this is what everybody really wants (despite what they said they _think_ they want): 1. Create a new `install.sgml' (let's just use this as an example chapter). 2. Copy everything from to . 3. Add an entry to chapters.ent 4. Refer to the new SYSTEM entity in place of the old .. 5. Commit. 6. Repeat until all chapters moved to their separate files. After that, moving questions out of inappropriate chapters into the correct chapter, combining Q&A entries that mean essentially the same thing (in a separate commit, I assume). Finally, arranging the chapters in .. groups, and questions into .. groups. This should not require any branch operations and in theory will not leave any part of the FAQ unbuildable ("in theory" leaves me room for a few minor screw-ups). General consensus? -- +-------------------+-----------------------------------------------------+ | Chris Costello | Stack manipulation - the use of inflatable falsies. | | chris@calldei.com | -Datamazing, 4/1/78 | +-------------------+-----------------------------------------------------+ To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message