On Fri, Jul 24, 2009 at 1:16 AM, Michael C.
Harris<michael.twof...@gmail.com> wrote:
> I've done a little more investigation into providing structure for a
> MediaWiki instance and concluded that a URL-based structure with
> everything in the main namespace, as outlined in our Wiki Structure[1]
> document and as we're already using for things like classes, is
> fighting against how MW was designed to work.

Before going too much further, can I ask that we start at question 0?

0. Is MediaWiki the best option for us?

I know it's popular, and offers some tremendous functionality. My
question is: are we likely to leverage all that functionality? Or is
MW overkill for our specific purposes?

I don't have a positive recommendation for any other tool at this
time. I could be flippant and say "Let's use Habari for our
documentation!" and that may be worth exploring; but I'd like to
re-evaluate whether MW is the best tool for the job, or whether we're
trying to push a square peg through a round hole just because that's
what everyone else does (and because we already have it installed and
somewhat populated)?

> The main namespace holds pages aimed at the new user, and the
> community in general. We create custom namespaces, dev and core. These
> correspond with what we were going to put at /dev and /dev/core.
>
> This has a number of advantages, including:
> * Namespaces can be searched independently
> * Pages can be styled based on namespace
> * Page titles are slightly nicer than the URL structure

If we stick with MW, that seems to make much more sense than a strict
URL hierarchy within the core namespace.

> On top of the namespaces, we make better use of categories. For
> example, all the classes should be in the core namespace and the class
> category, documents about releases should be in the main namespace in
> the release category, etc.

Again, that makes sense.


Cheers,
Scott

--~--~---------~--~----~------------~-------~--~----~
To post to this group, send email to habari-dev@googlegroups.com
To unsubscribe from this group, send email to 
habari-dev-unsubscr...@googlegroups.com
For more options, visit this group at http://groups.google.com/group/habari-dev
-~----------~----~----~----~------~----~------~--~---

Reply via email to