discuss: ldp wiki
Subject:
Re: [discuss] ldp wiki
From:
David Lawyer ####@####.####
Date:
31 May 2008 07:10:32 +0100
Message-Id: <20080531061730.GC2054@davespc>
On Tue, May 27, 2008 at 12:37:50PM +0100, David Greaves wrote:
> Svetoslav P. Chukov wrote:
> > From my point of view I would say that the key points for the LDP are the
> > following:
> > - easy way of accepting articles, howtos, tutorials for review.
> agree
>
>
> > One of the problems I noticed in LDP is the huge waste of time when a
> > contributor wants to write some howto. At this point we have to understand
> > that this author is related to his work. So, if he/she wants to contribute
> > something then he/she wants to contribute it now. Not in 1 month or 1 year.
> > It is too late.
> yes.
>
> > So, a new model of organization at LDP is needed for successful work. I
> > would think that mix of a small incoming buffer and regular "documentation
> > days" where the materials from the temporary buffer will be submitted for
> > acceptance.
I have written a howto on a sampling review which would be a lot
faster than an ordinary review. See a future post I'll make
>
> This is why I suggested a technology that accepts any text - now - and marks it
> as 'draft'.
> It can then be edited by anyone (author, LDP, others) and technically reviewed.
It's likely to just sit there and slowly become obsolete.
> It is given a time-to-live.
>
> Then it can become an LDP approved document.
>
This may not work in all cases. The author need to designate sections
and subsections etc. and a plain text submission may not make this
clear. Since linuxdoc is accepted by LDP and not much harder to learn
than wiki markup, I think it reasonable for authors to at least learn
it or possibly use LDP's Howto Generator which outputs linuxdoc.
For formats other than LinuxDoc or DocBook, LDP will try to find
someone to convert, but the author needs to be made aware of the
reason for the delay in publishing and perhaps help find someone to do
the conversion. Possibly, as a last resort, the author could learn
linuxdoc or use a wiki markup which converts to docbook (but the
author must make this conversion). Note that the knowledge gained in
learning the rudiments of linuxdoc will be useful if one wants to
learn DocBook later on.
David Lawyer
