discuss: Processes was Re: Fedora Multimedia Installation HOWTO
Subject:
Re: Processes was Re: Fedora Multimedia Installation HOWTO
From:
Emma Jane Hogbin ####@####.####
Date:
7 Feb 2004 07:03:17 -0000
Message-Id: <20040207070043.GI7160@smeagol>
On Fri, Feb 06, 2004 at 08:11:57PM -0600, Rodolfo J. Paiz wrote:
> New authors are not REQUIRED to read the Author Guide, but by golly they'll
> likely produce documents that are better and easier to work with if they
> do. The "waste of time" thing sounds egomaniacal, especially considering
> the "importance of my time" addition. However, I do like the Quick Start
> guide idea... something like (in oversimplified form):
>
> 1. This link shows you how to write DocBook XML
> 2. This other link is Saqib's online validator
> 3. This other link is Saqib's converter to HTML output
> 4. Now you can submit documents!
> 5. Or just write in HTML/TXT and we'll help you.
I believe this is the page you're looking for:
http://tldp.org/LDP/LDP-Author-Guide/html/process.html
All points are cross-referenced to the appropriate chapter including a
note at the end which reminds authors they can submit the initial document
in any format they wish, but the document must be maintained in either
DocBook or LinuxDoc (the author can choose).
Pointing to Saqib's tools is not appropriate for a summary page as new
documents do not have to be in any particular format. They are listed as
the first paragraph (typically in "warning" markup) to the relevant
sections of the Guide.
[This final note is NOT in reply to Rodolfo's email. It because I still
pissed off at David's original off-list email and Mr. Raymond's statement
that policies set in place in 2001 in the Reviewer HOWTO were somehow
"invented" while he "wasn't looking."] I don't really care if I sound like
I'm being emotional. I am /hurt/ by the fact that I spent EIGHT MONTHS
working on the Author Guide and David feels he can dismiss the document
as "waste of time"--without even bothering to look at the changes that
were made. In my mind you shouldn't be staff if you're not willing to read
the policies and procedures of your own organization.
I really would encourage people to read the revised Author Guide. It won't
take as long as you think (and you can skip all of the technical stuff
as it has been moved to Appendices). Based on off-list comments I've
received I don't think people understand exactly how different the Guide
is now...the least you can do is scan the table of contents so that you
don't make stupid comments to me off-list about how shit the document is.
emma
--
Emma Jane Hogbin
[[ 416 417 2868 ][ www.xtrinsic.com ]]
