Re: [jokosher-devel] Building a community docs site

["Stuart Langridge" <sil kryogenix org>]

> bottleneck is me. The problem is that I can't restrict access to
> certain pages on the main Jokosher website for the docs team easily.

WP2.0 has the Roles and Capabilities stuff. It looks to me as though
it might be possible to enable editing of others posts, which would
make this possible.

> There other problems with out current approach:
>
>  * We can't support user comments. If a user reads something in a
> guide and wants to make a comment (like with the PHP documentation),
> this cannot happen effectively.

Rubbish. Wordpress Pages can have comments. :)

>  * We can't easily support user contributed guides. Use contributed
> guides would need to go through the doc team and then onto the main
> site after they have been marked up via the doc team. Also, user
> contributed guides would require hundreds of trac login accounts
> setting up, and I would rather keep trac logins to core developers.

I don't think we should support them, though. We want to keep a high
standard of documentation, which means that the Doc Team should
steward these things a bit. There's nothing stopping us linking to
some third-party documentation if it's good enough to show to users
but not good enough to meet our standards.

>  * Jokosher wiki where people can add notes, guides and best practices.
>  * Provide an indexable collection of guides, HOWTOs and more
>  * Provide case studies, examples, tutorials, interviews and other content
>
> As such, the site becomes an 'information portal' about all kinds of
> Jokosher related content.
>
> So, the question is - does this make sense, and how do we make it
> happen? It strikes me that a customised MediaWiki that fits in with
> our current design would make the most sense, but I am keen to hear
> everyones thoughts. Personally, I would suggest against a custom built
> web app for it because if the developer of it goes away, we are stuck.

Agreed on no custom web app. However, I think that wordpress will do
everything we need it to except be a wiki, and installing a wiki is
easy. (I've recently fallen in love with Dokuwiki rather than
Mediawiki, since I used it for the Jackfield site, but each to their
own.)

sil

--
Java sucks. [...] Java on TV set top boxes will suck so hard it
might well inhale people from off  their sofa until their heads
get wedged in the card slots.         --- Jon Rabone, ucam.chat