Forum OpenACS Q&A: list of things to be improved on openacs.org

This thread shall become a list of issues that would improve
openacs.org.

I gave each item a priority that ranges from "1 = really important"
to "5 = we can wait a bit on that".

At the same time volunteers can come forward and tell the godfathers
(just kidding) what job they want to take over. This way we can avoid
that people work parallely on the same issue.

In the future we might use an improved sdm to create a roadmap which
lists all issues that want to be addressed by certain community
members.

Everybody could rank the priority of each individual issue and
comment on it. On the other hand Don, Ben or Roberto etc. could
comment on wether the issue is valid or simply stupid and not to be
realized on openacs. If it is valid, "DBR" could either assign some
volunteer to this job or do it themselves. Every valid issue would
get a deadline timestamp and everybody would be happy and anxiously
waiting for i.e. the new layout... (At least me 😊

These are my issues:

1. Nice layout for all openacs.org pages (priority 2)

2. Business style logo (priority 3)

3. A page that links to all available modules at openacs.org
(priority 2)

4. Populating each module with examples (priority 2)

5. Offering a link to the users documentation for every module.
Writing the users documentation for every module (priority 3)

6. Offering general-comments on all documentation pages (priority 2)

7. Activating Pascal's SDM patch (priority 3)

8. Activating the valuable patches at openacs.org/sdm (priority 3)

That's all I can think of now.

Feel free to express your own issues and priorities...

I just checked out php.net and the interactive postgresql
documentation.

How do they differ from an openacs documentation with
activated general-comments on every doc page?

I would Love a standard set of browseable docs that I could comment on. There have been so many times that I have wasted hours rooting around in the source code of a module because its documentation was lame and out of date. I even submitted a patch recently to address a particularly egregious flaw with the news module. But who knows how long it will be before that will be rolled into the current /docs, and how many other submissions have been made by other people that I might have benefited from?

Cheers,

Carl CM