[oe] Documentation problems

[Tom Rini]

On Sun, Nov 27, 2011 at 8:44 AM, Koen Kooi <koen at dominion.thruhere.net> wrote:
> -----BEGIN PGP SIGNED MESSAGE-----
> Hash: SHA1
>
> Op 27-11-11 03:40, Tom Rini schreef:
>> Hey all,
>>
>> As things stand today, the wiki is out of date and a number of folks
>> refuse to work on it.
>
> Does it actually need to be a wiki? Or rather: do web edits need to show up
> immediately?

If spam is eliminated, does it still matter, today?

>> Paul Menzel has mentioned that ikiwiki has been mentioned before and that
>> lets us have the website in a repository.  Do folks have other ideas?
>
> I really like the idea of storing the content in git since it gives us 2
> things we need for documentation: backups and a pull model.

The number one thing we lack today is people willing to document.
Everyone, myself included, who has said we need X done to the public
documentation today, has generally found a point at which they stop
wanting to keep things up to date.  Why?  What would change that?
Does anyone reading this know people that _like_ editing wikis?  Can
we ask them what keeps them engaged in the process?

-- 
Tom