[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