I don't think it's a good idea to include wiki content in a release. What I've seen other projects use their wiki space for effectively is:
* Contributor guides * Tutorials * Design documents/proposals I think the reason that some wikis experience content rot is they never build a big enough user base and they're outside of the release process so there's no forcing function to review that content is up-to-date. For communities that are still relatively small, you can tag specific pages as things that should/need to be periodically reviewed and could assign JIRAs or some other notification mechanism to kick off a review. -Joey -- Joey Echeverria Chief Architect Cloudera Government Solutions On Wed, Apr 23, 2014 at 11:19 AM, Bill Havanki <[email protected]> wrote: > Quick note that if any of the wiki content is intended to be bundled in a > release, then editing must be restricted to those who've signed a CLA [1]. > The same restriction is surely in place for MoinMoin, but I don't see a ref. > > [1] > https://cwiki.apache.org/confluence/display/INFRA/Cwiki#Cwiki-Butwhatifwewouldlikethecommunityatlargetohelpmaintainthespace > ? > > > On Wed, Apr 23, 2014 at 11:11 AM, Sean Busbey <[email protected]> wrote: > >> I want a place to put contributor self-help materials. The bar for granting >> someone edit access to a cwiki space is way lower than edit rights on our >> main site. >> >> >> On Wed, Apr 23, 2014 at 10:00 AM, Billie Rinaldi >> <[email protected]>wrote: >> >> > We originally evaluated whether we would have a wiki and decided against. >> > I don't mind reevaluating now, but it should not be a foregone conclusion >> > that we should have one. Often when projects have a website and wiki, >> it's >> > confusing where to look for which information. Also, project >> documentation >> > that is on the wiki is often out of date. If we want to consider setting >> > up a wiki because it would be better than our website for housing some >> > specific types of information, I'd like those types to be identified >> before >> > we start. >> > >> > Billie >> > >> > >> > On Wed, Apr 23, 2014 at 7:47 AM, Bill Havanki <[email protected] >> > >wrote: >> > >> > > There has been talk about establishing some wiki space for the Accumulo >> > > project. ASF offers two wiki platforms: MoinMoin at wiki.apache.organd >> > > Confluence at cwiki.apache.org. Each has pros and cons, and if we >> > > establish >> > > a wiki we should just pick one. >> > > >> > > I believe the MoinMoin site is more prevalent ASF-wide, and there is >> > > already a Hadoop wiki [1] established which we would go under. We can >> > > request members of its AdminGroup [not viewable] to add us to the >> > > ContributorsGroup [2], and then we would be able to author content. (We >> > can >> > > ask infra as well.) >> > > >> > > The Confluence site offers some extra features like commenting and >> > perhaps >> > > looks nicer (certainly subjective). There is a page [3] touching on >> some >> > > differences. To get started there, we would request a "space" from >> infra. >> > > >> > > Related projects on MoinMoin: Hadoop, HBase >> > > Related projects on Confluence: Hive, Pig, ZooKeeper (all having >> migrated >> > > from MoinMoin) >> > > >> > > So, questions to be answered: >> > > >> > > 1) Shall we establish a wiki? (I can call a vote if needed.) >> > > 2) Which platform? >> > > 3) Who is interested in edit rights? >> > > >> > > [1] https://wiki.apache.org/hadoop/ >> > > [2] https://wiki.apache.org/hadoop/ContributorsGroup >> > > [3] https://cwiki.apache.org/confluence/display/INFRA/Cwiki >> > > >> > > Thanks >> > > Bill H >> > > >> > > -- >> > > // Bill Havanki >> > > // Solutions Architect, Cloudera Govt Solutions >> > > // 443.686.9283 >> > > >> > >> >> >> >> -- >> Sean >> > > > > -- > // Bill Havanki > // Solutions Architect, Cloudera Govt Solutions > // 443.686.9283
