discuss: Looking for advice on publishing documentation.
Subject:
Re: Looking for advice on publishing documentation.
From:
"Dave" ####@####.####
Date:
31 Oct 2002 14:06:00 -0000
Message-Id: <200210311405.g9VE5sH50846@mail0.mx.voyager.net>
Dave,
Thank you for the offer of converting to docbook. I'd like to do a
little editing and cleaning up and then I think the diskette-sized
distribution part will be ready to convert. As soon as I am done I will
post a tarball of those files on my website
(http://my.core.com/~dhorton/linux/diy/) and let you know. Thanks again
for offering to help.
Dave
P.S. To the group...
Would the smaller diskette-based project be the right size for a how-to?
It is located at: http://my.core.com/~dhorton/linux/diy/pocket/index.html
> BTW - As for the format, I'd be honored to convert the guide into
> DocBook/SGML. Just send me a tarball of the files (email attachment's
> fine), and I'll send you back my best try at turning it into DocBook.
> (I've been learning about DocBook and translating my own docs (diary,
> etc.) into DocBook during the past few months, and I'm looking for a
> major project to test myself on. As you can guess, I'd like you to be
> my lucky guinnea pig. . .)
>
> - Dave
>
>
> On Tue, Oct 29, 2002 at 01:14:34PM -0500, Dave wrote:
> > Dear Linux Doc Project Gurus,
> >
> > I have been working on some documentation that details how to build a
> > Linux distribution using source code only. The finished product is a
> > little like Linux From Scratch, but the process in which the system is
> > built takes a different approach. Basically, rather than doing
> > everything at once, the system is built in small stages. Each stage
> > adds more functionality and makes the system a little more robust.
> > Hopefully this approach will enable users of the documentation to get
> > into system building gradually and learn a little about software
> > development along the way.
> >
> > I would like to submit this work to the Linux Doc Project, but I have a
> > few concerns.
> >
> > 1 - I think it is too big to be a HOWTO and would better qualify as
a Guide.
> > 2 - The work is in HTML and I have read that TLDP requires Docbook for
> > HOWTO's and such.
> > 3 - I know nothing about authoring in SGML or Docbook at the present
time.
> > 4 - So far I am the only person who has tested the validity of the
> > information in the document.
> >
> > Does anyone have any advice on these concerns?
> >
> > The project can be viewed at: http://my.core.com/~dhorton/linux/diy/
> >
> > Dave Horton
> >
> >
> > ______________________
> > http://lists.tldp.org/
>
> --
> When you say "I wrote a program that crashed Windows", people just stare
> at you blankly and say "Hey, I got those with the system, *for free*".
> -- Linus Torvalds
>
> Linux: because a PC is a terrible thing to waste
> -- ####@####.#### put this on Tshirts in '93
>