Re: documentation which is now officially listed as 'stalled'
Adam Di Carlo <email@example.com> writes:
> In article <[🔎] firstname.lastname@example.org>, Ardo van Rangelrooij <email@example.com> writes:
> > 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
This will then also put an end to the reoccurring "why not DocBook" issue.
(Ok, go ahead, shoot me for this remark.)
Seriously, this would be great.
Talking about architecture: How are things in the Debian Meta Documentation
> <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?
> 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?
> >> * 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
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.
Ardo van Rangelrooij
home email: firstname.lastname@example.org, email@example.com
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