discuss: suspending and removing docs
Subject:
Re: suspending and removing docs
From:
"Tabatha Persad" ####@####.####
Date:
15 Mar 2002 05:27:41 -0000
Message-Id: <044701c1cb19$12321ea0$0928a8c0@voodoochild>
That sounds like an excellent way to prioritize as well - that is to say, if
the rating system showed that a particular document needed much revision to
update it, this may be moved up in the list of high versus low priority.
I have taken a look at the GDP and they have a complex system to track
revisions and status of the documentation. Is there anything similar at
LDP?
I'm new, so maybe I just don't know about something that is already in
place. I don't think it would be a very complicated task, but with such a
large project, it's a good idea to make sure there's not duplication of
effort... so maybe a page that lists current projects under review and who
is assigned, that sort of thing. Not that people shouldn't arbitrarily be
able to pick something up and work on it if they're good at it, but wouldn't
it be better to just join that project instead of working anonymously?
Tabatha
----- Original Message -----
From: "Joy Y Goodreau" ####@####.####
To: ####@####.####
Sent: Thursday, March 14, 2002 8:14 PM
Subject: Re: suspending and removing docs
> I think it would be a good idea for LDP members to become actively
involved
> in reviewing and rating documentation on the site. Who better to check out
> and rate the docs than a community that stays involved and interested in
> documentation.
>
> I think an excellent solution would be for the rating system to cue a
> specific review of the document in question. The call for reviewers would
> go out to the discuss list and reviewers could volunteer based on their
> areas of expertise. Reviews of the document would involve multiple
> reviewers (2 or 3) offering feedback and areas of improvement along with
> good, positive criticism. This way we are not only excluding documents but
> improving them. Should the author fail to make the adjustments, the
> document is pulled. The reviewers will be able to make this call based on
> the revision the author submits.
>
> If the document is pulled we are still left with an excellent outline from
> the reviewers of what would make a good document on that topic.
>
> I know that this is more complex than a simple vote, but I am hoping that
> it also allows us to vote more fairly because we can say that the document
> does have good information in some parts but is wrong in others. This way
> we can keep the good and make the bad better.
>
> I am open to other suggestions.
>
> Thank you,
>
> joy
>
>
> Joy Yokley Goodreau
> Linux Information Development
> IBM Linux Technology Services
> 512-838-4118
> ####@####.####
>
>
>
>
> David Merrill
> <david@lupercalia To: ldp-discuss
####@####.####
> .net> cc:
> Subject: suspending and
removing docs
> 03/14/02 10:23 PM
>
>
>
>
>
>
> How do we want to get documents suspended from publication, or even
> pulled from the collection? We have now had two documents reported to
> us that need to be improved or they need to be pulled. The first was
> the PostgreSQL one that we pulled awhile ago.
>
> Shall we leave that to the discretion of the Editor? And I understand
> Joy is new in that role, but I've worked with her quite a bit and
> found her always professional, reliable, and sound of judgement. So
> take that for whatever you think it's worth.
>
> I have in the database a way for you to rate each document on a scale
> from 1 to 10. Only once per username, of course. You must be a
> registered user. Therefore, we have a metric we could use. Shall we
> remove a document if its rating is lower than 3? Requiring at least 10
> votes, to make sure it uses a sizeable number of data points, of
> course.
>
> We need some kind of democratic process so we can make this kind of
> decision. Any other ideas glady considered.
>
> I don't mean to single anyone out by this, either. We will continue to
> raise our standard of quality, and we should.
>
> Thanks,
>
> --
> David C. Merrill http://www.lupercalia.net
> Linux Documentation Project ####@####.####
> Lead Developer http://www.linuxdoc.org
>
> Gates is trying to make sure that he has a proprietary position in
> controlling the tools that allow you and me to access information. And
> that's profitable by definition. How would you like to own the printing
> press?
> --PaineWebber Media Analyst Christopher Dixon
>
> _________________________
> http://list.linuxdoc.org/
>
>
>
>
> _________________________
> http://list.linuxdoc.org/
>
>
