Other projects allow wider access to edit wiki pages. The ones I'm
aware of restrict editing to folks who have signed an ICLA. This does
two things:
1. It raises the bar for potential wrong-doers (spammers);
2. It allows the project to use the ideas in the wiki without worrying
that the contributor didn't intend the wiki comments as a contribution.
That said, you can restrict wiki edit privileges however you (the
project) want to. I'm just suggesting that you might find it easier to
deal with roles than individuals as a restriction tool.
Craig
On Aug 17, 2010, at 10:52 AM, Jerome Renard wrote:
Hi Tobias,
On Mon, Aug 16, 2010 at 3:40 PM, Tobias Schlitt
<[email protected]> wrote:
Hi all,
Derick and me just discussed the usage of our Wiki. While a wiki is a
cool way for users to contribute docs and I personally see quite some
uses for it, Derick objects that wikis tend to get a mess quickly and
that we need to watch changes all the time, to avoid having BS in it.
I therefore think, we should restrict access to the wiki in
reasonable ways.
I imagine to use the wiki for two essential purposes:
1. Develop requirements / design docs for new components (new
features)
2. User contributed comments about components
+1
Note that this does not mean to migrate our official docs into the
wiki
in any way. Accepted component / feature proposals will be migrated
to
corresponding component dirs and official docs will stay where they
are.
By now, our wiki can only be edited by users of the group
zetacomponents-commiters, which is only the PMC so far. My
suggestion is
to keep this status per default and only allow other users to edit
dedicated pages. As there are:
- One page per component, where users can provide code snippets,
share
comments and so on.
- One page where proposals (requirements / design) can be maintained.
Note that a page in Confluence can have sub-pages, so that does not
necessarily mean that only a single page for proposals will exist,
but a
dedicated name space.
If we find more reasonable applications for the wiki, we can open up
more areas.
What do you think?
I agree with you. Just a quick note though, there should be a page on
the wiki, available to everyone
explaining what you said above in order to avoid confused users.
Cheers :)
--
Jérôme Renard
http://39web.fr | http://jrenard.info
Craig L Russell
Architect, Oracle
http://db.apache.org/jdo
408 276-5638 mailto:[email protected]
P.S. A good JDO? O, Gasp!
