[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
Re: Blank template
On Thu, 15 Jun 2000, Chuck Dale wrote:
> > > > So, am I going a good direction with this? Too many
> > > comments? Too few?
> > > > Greg
> > >
> > > I'm assuming this is aimed at the extreme novice Docbook
> > > author; if so, you're
> > > right to err on the side of overkill.
> >
> > ok, I'll stick with lots of comments.
>
> Ah I'll throw a paddle back in the other direction: way too many
> comments. The template needs to be concise to be usable, and some things
> are overkill. Like this:
[...]
I agree with Chuck. I'd rather the template be just that -- a template. No more
and no less. With the entire text of DocBook: TDG available online, there's an
excellent reference available to everyone, to explain the meaning of any tag.
I have a bias toward keeping all the documentation together in one document,
the LDP-Authoring-HOWTO, instead of spread out between there and comments in
the template(s). I see the template as a kind of "Appendix", or supplemental
material, to the Authoring-HOWTO. It doesn't need to stand on its own.
--
David C. Merrill, Ph.D.
dcmerrill@mindspring.com
--
To UNSUBSCRIBE, email to ldp-discuss-request@lists.debian.org
with a subject of "unsubscribe". Trouble? Contact listmaster@lists.debian.org