[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
Re: HOWTO submission (and QC)
Allow me to take any blame for what's in the HOWTO-HOWTO. I'll see
about incorporating your comments in my next rev. Any of you QC people
are of course free to forward me any QC "hints" that you have.
-Mark
Tim wrote:
>
> Hello,
>
> 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
> document(s).
>
> 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
>
> eg.
> *INCORRECT*
> <author>John Smith <tt/jsmith@righhere.com/
> <date>VERSION 0.99, 17 Sept 1999
>
> *CORRECT*
> <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,
> Tim
>
> --
> Linux HOWTO coordinator http://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!
> http://wallybox.cei.net/dipc/
>
> --
> To UNSUBSCRIBE, email to ldp-discuss-request@lists.debian.org
> with a subject of "unsubscribe". Trouble? Contact listmaster@lists.debian.org
--
To UNSUBSCRIBE, email to ldp-discuss-request@lists.debian.org
with a subject of "unsubscribe". Trouble? Contact listmaster@lists.debian.org