[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

Re: DocBook Walkthrough?




Three things below:

I.   I would love to see a docBook Walkthrough
II.  Questions regarding the overall direction of the Linux
Documentation
Project itself.  the tools vs documentation in general.
III.  appreciation for what this project is producing, I learn from and
use the
results here regularly.


I.  First of all the Doc book walk through: Can we do this live on the
net,
with someone who is familiar with and uses DocBook to produce
documentation for
LDP?   When And Where?  Tell me and I'll show up.  Point me to a
document and
I'll read it start to finish.

II.  Second,  There seems to be a lot of resistance and FUD on the list
about
DocBook and SGML.    I wonder if the documentation project could benefit
from
more active discussion of "What is it we're trying to do exactly?"
rather than
"What tools are we using (today, yesterday and tomorrow) and how do they
work?"
or "Which tool is best for what"

Read through the following and see if you agree or disagree with any of
it.

Warren Chartier wrote:

> On Sat, 13 May 2000, jdd wrote:
>
> > may I quote that the content of this thread shows as an evidence why
I did
> > NOT switch to docbook. A question asking for a syntesis document
gives
> > more and more cryptics answers.
> >
> > I could use linucdoc in a day or so. If I must learn that sort of
things
> > to run docbook, I will not do that now!
>
> I had LinuxDoc up and running in hours, I've read the revised
HOWTO-HOWTO,
> followed instructions (where there were instructions, a lot of parts
in
> the HOWTO-HOWTO just say "refer to here for instructions", and there
never
> is any) and still don't have a working DocBook installation.
>

Is there information available in this project on "documentation"
without
reference to "specific tools"?  Have any of the members of this project
experience in data modeling and requirements gathering?  There are many
ways to
use documentation.  Has this been analysed and discussed publicly, or
are we
operating today with a limited model of documentation  based on what a
few of us
can see in the rear view mirror.  Has this research and analyis work
already
been done?  If so where are its results?

III.  Finally, I appreciate the ongoing work of this project and the
hard work
that its members and participants have done to improve the
documentation.
Lately, I've seen several excellent new documents appear here, and the
herculean
effort to get the Howtos converted to more formal document structures
and
provide them in a variety of formats has quite literally cleaned the
stables and
generated renewed interest in developing and maintaining them.  Thank
you to all
who worked on this.

-Pat







--  
To UNSUBSCRIBE, email to [email protected]
with a subject of "unsubscribe". Trouble? Contact [email protected]