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

Re: HOWTO submission (and QC)


A few comments regarding QC and maybe folks will sleep a little better.

All documents that are sent to ldp-submit are reviewed.  As for the
comments regarding contact w/in 24hrs, well let's just say that I didn't
make them, but this is *not* to say that it should not be the case.

This information was provided in the HOWTO-HOWTO which I did not write or 
make any contributions towards, but is still very beneficial.

Comments to authors submitting docs to ldp-submit should be contacted in
regards to their submission. This was not the initial purpose of
ldp-submit, but will be in the very short future.

I am currently (and have been for a while) working on a revised QC
Manifesto and will have it completed (if all goes well) by Wednesday the
20th of October.

In short this is what I hope it will accomplish and what I and others will
strive for:

* A quick review of all documents (FAQs, HOWTOs, mini-HOWTOs, etc.)

        A document should (at least at this point) make it to metalab on
        one (1) of two (2) uploads per week.  This will fall on Wednesday
        or Sunday right now and as things progress will become as
        automated as possible w/out neglecting the validity of the doc
        itself and/or any errors that occur.

* immediate response

        The first response will be a tracking number.  This will give a
        date and time association with this number and will better allow us to
        serve our customers (those being the authors or those maintaing the

        The second will be a personal response stating that the document
        has been reviewed (whether old or new) and processed, meaning
        that it's met the sgml requirements and complies with the
        linuxdoc.dtd hasn't failed processing due to an invalid or
        improper use of a tag.  This also means if you send a doc and you
        have used the <author> or <date> tag incorrectly

        <author>John Smith <tt/jsmith@righhere.com/
        <date>VERSION 0.99, 17 Sept 1999

        <author>John Smith, <tt/jsmith@righthere.com/
        <date>v0.99, 17 September 1999

        that you may receive this document back.  This is part of the
        automation process that everyone is wanting, so restrictions have
        to be imposed for the sake of all.  Failure to comply will result
        in your receipt of the doucment for corrections as I will no
        longer be able to take the time to manually correct your documents
        as I am constantly doing now.

* A timely processing and upload of the document.
        Again, this is currently an upload on either Wednesday or Sunday.

There are many more responsibilities of QC, but these are a few that I
feel are most important.

As stated above, you will have a revised QC Manifesto by mid-week for your
viewing/flaming pleasure.

I look forward to any and all comments.

Best Regards,

Linux HOWTO coordinator http://www.linuxdoc.org/HOWTO/
tjbynum@metalab.unc.edu, linux-howto@metalab.unc.edu (HOWTO's)
tjbynum@wallybox.cei.net (Home)
tbynum@rineco.com (Work)
http://wallybox.cei.net:5119/cgi-bin/pageme.cgi (Alpha Pager)

                                D I P C
   The system that enables you to write distributed programs.......the
   easy way!

To UNSUBSCRIBE, email to ldp-discuss-request@lists.debian.org
with a subject of "unsubscribe". Trouble? Contact listmaster@lists.debian.org