Adam Di Carlo <[EMAIL PROTECTED]> writes: > In article <[EMAIL PROTECTED]>, Ardo van Rangelrooij <[EMAIL PROTECTED]> > writes: [snip] > > I'm not sure I agree the guidelines should be incorporated. These > > have nothing to do with the debiandoc-sgml itself, but more with how > > the documentation should be written (for instance, using > > debiandoc-sgml). If we switch to another DTD and/or set of tools, > > the guidelines should still be applicable. > > Good point... we need a maintainer.
Why don't we follow the same approach as with the Debian Policy Manual, i.e. a team of maintainers? > BTW, what Craig suggested on Debian Policy is good. In other words, > (from IRC): > > <craig> You may at some point want to definea debiandoc architecture, of > | while the debiandoc DTD is a perfect implementation, but allow translation > | from other DTDs > > I think this would be really cool; you could write debiandoc documents > in docbook or whatever... See <nag> This will then also put an end to the reoccurring "why not DocBook" issue. </nag> (Ok, go ahead, shoot me for this remark.) Seriously, this would be great. Talking about architecture: How are things in the Debian Meta Documentation Data world? > <URL:http://www.isogen.com/papers/archintro.html> for details. Anyhow, > something for a rainy day. Maybe you should consider moving to the Netherlands. Plenty of rainy days in the last few months. > > Integrating the "How to get started ..." is a good idea. I've > > already copied the ddsample.ta.gz as well as printed the proposed > > TOC. I was already planning on extending the debiandoc-sgml manual, > > so this might be a good starting point. > > Ok, I'll note this... > > Oliver, please go ahead and nuke the 'How to get started' and loose > tarballs, I think... right, Ardo? You got all you need? Yep! > Ardo, one other point. I was considering writing up a little section, > 'how to use debian/changelog for automatic date and versioning'. Do > you think this would be good? You mean for in the markup manual? Yeah, sure, no problem. Sounds interesting. Maybe we could also discuss a new setup of the manual? [snip] > >> * Debiandoc-SGML Markup Manual > > > Although not maintained within the DDP CVS are, it probably still > > would be nice to have it on the pages, together with the gidelines > > (see above). Maybe we simply have to put it under the DDP CVS > > instance so I can update it when a new release of debiandoc-sgml is > > done. > > If you want to do this, that would be great. If it's going to slow > you down, don't bother. I'd be happy to help with the initial import > of the data, or moving it from cvs area to another if you use cvs > locally. It's no problem to keep the DDP CVS instance up to date. It'll just be another upload. It would be great if you could do the initial import. And yes, I have all the package sources locally under CVS (of course). So, how do we proceed? I didn't quite understand the part of moving the CVS area. Thanks, Ardo -- Ardo van Rangelrooij home email: [EMAIL PROTECTED], [EMAIL PROTECTED] home page: http://www.tip.nl/users/ardo.van.rangelrooij PGP fp: 3B 1F 21 72 00 5C 3A 73 7F 72 DF D9 90 78 47 F9
