[dokuwiki] Re: Recent massive changes on wiki.splitbrain.org
- From: "Andreas Gohr" <andi@xxxxxxxxxxxxxx>
- To: dokuwiki@xxxxxxxxxxxxx
- Date: Thu, 24 Jul 2008 18:34:53 +0200
Hi Colin,
welcome to the list. Thanks for taking the time to explain your actions.
> 3. Finally, what would I like to do (or be done) ?
Let me explain how I would restructure the wiki:
I agree that the documentation in the wiki could be organized a little
bit better. I am however not a friend of deeply nested namespaces.
Flat hierarchies work much better for linking. I don't want to think
about what namespace I need to link to. A good example of a flat
hierarchy that works extremely well is Wikipedia. Everything (except
meta stuff) is in the same toplevel namespace.
One thing that bugs me for example is the wiki: namespace. It is
superfluous because 99% of the wiki is about DokuWiki. It would make
more sense to move the few personal stuff I store at the wiki in my
own namespace (or move it of this wiki completely).
I could do this change and set up some redirecting to not break any
links if everybody agrees.
For some things I think namespaces still make sense, and the following
are the ones I'd suggest:
:* the top namespace for any feature/philosophy/concept/manual
(current pages like wiki:images, wiki:farm or wiki:camelcase would go
here) prety much like the current wiki namespace
config:* here would be a page for each config option from
(conf/dokuwiki.php) named exactly like the option. The contents would
be taken from current wiki:config. wiki:config (now just :config)
would have your proposed introductionary text and a nested list
resembling the current sectionstructure linking to the pages in
config:.
devel:* everything development related would be explained here
(current wiki:devel:* goes here) some content from wiki:plugins:* and
wiki:tpl:* wiki:auth:* should be moved here too.
plugin:* as it is now, one page per plugin
tpl:* (maybe rename to template:*) one page per template similar to
the current plugin structure
auth:* like templates and plugins, but for authentication backends
I'd like to get rid of the discussion namespace completely. Most of it
is really outdated and predates the introduction of the forum.
Discussion should take place in the forum now.
We should also add some page explaining the structure of the wiki, and
how to contribute to it.
Most pages should continue to be publically editable, that's what a
wiki is about (exceptions only for key pages prone to vandalism and
spam attacks)
What we should keep in mind, when we agree to restructure the wiki
like this are the following things:
* links have to be adjusted through the whole wiki
* translated pages have to be restructured when possible without
knowledge of the language
* if not possible without language knowledge a warning about the
page needing attention has to be added
* when touching most of the wiki anyway, pages should be cleaned up
as well (mostly transferring pages from discussion style to document
style -> delete comments, questions, answers and integrate their facts
into the content itself)
* the whole restructuring should be done in a big collective effort
on an agreed date (maybe over some weekend) to avoid having the wiki
in a inconsistent state for a longer time, having contributors in the
IRC at the same time might be a good idea as well
I think the DokuWiki documentation would greatly benefit from these
changes. What does everybody else think? Would you join the cleanup
weekend? Is my proposed structure agreeable? Anything I forgot?
Andi
PS: sorry for another of those long posts. I hoped to write up a short
proposal, but it somehow got out of hand.
--
splitbrain.org
--
DokuWiki mailing list - more info at
http://wiki.splitbrain.org/wiki:mailinglist
Other related posts:
