Chris Fedde writes: > I wonder what you all think of making a different structure for > the FAQ. I'd like to see each =head2 be a separate source file. > This way the number of CVS commit conflicts can go down. And it > will be easier to add and delete FAQ sections and to track process > steps for each. A naming convention could be used to preserve > ordering and allow documents to be assembled on demand.
That was my original intention when I was going to put it into SourceForge. It's easy to split up. We'd just need a program to reform the FAQ. I had a directory for each section, and then a separate file per head2. Each filename was a number, which made assembly easy. > Finally has anyone given thought to commit policy for the FAQ CVS > repository? Branches? tags? A tinderbox might be useful too. This > would at least check that the documents are well formed. Maybe > also checking other objective features such as spell/grammar. Or > even lending support to editorial processes like peer review and > proof reading. As you've seen, nothing's fixed yet. I'd love to see a build testing tinderbox. Want to set it up? :-) For ToDo manager, we could set up another queue in the RT being used by Perl 6. Nat
