Forum OpenACS Q&A: Re: Encouraging Improved Documentation for OpenACS

Collapse
Posted by Jade Rubick on
Yes, Bugtracker is a good interum solution.

However, it is something I would have contributed myself, if it was easy to do so.

How many people are going to read the documentation and follow the notes example before someone fixes the documentation? It makes it harder for the documentation people, because the burden is all on them.

I'll go ahead and post a bug for it, but I still think a better solution is something where registered, trusted users can contribute to the documentation themselves, without having to learn Docbook or whatever.

This is just a suggestion. I'm sure there's a lot of other reasons Docbook is useful. Greenspun said that you can measure the success of a site by "how much content you contribute vs how much content the community contributes". I think anything we can do to make it easier for all of us to contribute to the documentation (without causing other problems) is going to be beneficial for all of us, but especially newcomers. Which grows the community, and helps the platform grow, etc..