Subscribe to RSS feed

splitbrain.org - electronic brain surgery since 2001

The Big DokuWiki Wiki Reorganization

Dokuwiki

This weekend was a pretty busy one for a handful of people from the DokuWiki community. We did a long overdue reorganization of the whole DokuWiki documentation.

The DokuWiki docs grew with the wiki. When I set up the first DokuWiki instance it was in a subdirectory here at the splitbrain.org site. It was my personal wiki which happened to store a bit of documentation for the software it self in the wiki namespace. When DokuWiki became more popular I moved the wiki to wiki.splitbrain.org, but still all docs resided in the wiki subnamespace.

Later I obtained the dokuwiki.org domain but did not use it for the wiki it self. It just redirected to wiki.splitbrain.org and was used for the forum at forum.dokuwiki.org.

This weekend I finally moved all my personal stuff off the wiki to a new site at notes.splitbrain.org. The DokuWiki documentation was moved out of the wiki namespace up to the toplevel and the whole wiki moved over to www.dokuwiki.org.

But the reorganization did not stop there. Instead we had a look at all pages and tried to reorganize them in a way that is more logical and consistent. Many pages were cleaned up or rewritten. A lot of outdated stuff was removed.

The content is now laid out like this:

  • All general “user level” documentation and feature descriptions are at the toplevel namespace
  • Each Configuration option has its own page in the conf namespace
  • Development documentation is available in the devel namespace
  • Plugins have their own plugin namespace
  • The same goes for Templates in the template namespace
  • And finally there are Tips and the FAQs in their own namespaces

Simple and quite obvious, but a huge improvement on the more scattered layout we used to have before.

There are still many parts of the docs that could use some cleanup, but I'm confident we will fix those in the next weeks as well.

I want to say a big thanks to all those who helped and spent their weekend with editing wiki pages. Thank you Michael Klier, Colin Lorrain, Boris Le Ninivin, Anika Henke, Felipe Uderman and Laynee.

Now, if you want to help here is what you can do:

  • Search for pages marked with NEEDSATTENTION or FIXME and clean them up
  • Check translations and update them to match their english counterparts
  • Help spreading the new domain www.dokuwiki.org by updating links in WikiPedia, your blogs or other websites
Tags:
dokuwiki,
documentation,
reorganization
Similar posts:
Posted on Monday, August the 11th 2008 (11 months ago).

Comments?

1
Great effort and a huge improvement to an already excellent wiki software and open source project! You guys rock!   :)

It would be nice if the download links also point to dokuwiki.org instead of splitbrain.
2008-08-12 05:13:32
Kelvin Quee
2
Hi, and thanks to the reorg team. The mother wiki needed this.
Andi I guess you took your time for this post and there should be no typo, I just want to understand it fully.
Two questions:
* "Check translations"
The link points to localisation. I don't understand what localisation has to do with the reorganization. 'Translations of this page' through the translation plugin are more relevant to check to me.
BTW, is it me or the behaviour of this plugin changed:
now a [[target]] link on trans:fr:page won't lead to trans:fr:target, it seems that the links are not processed like before.
* "Help spreading the new domain www.splitbrain.org"
I thought you meant promoting www.dokuwiki.org but maybe I'm wrong. Can you explain?
2008-08-12 11:39:33
Grahack
3
Grahack, I'm an idiot and shouldn't blog late in the evening when tired. Thanks for pointing out the errors, I fixed the links.

Yes translating refers to translating the content of dokuwiki.org which is explained at the localization page now.

The translation plugin behavior did not change except that all language namespaces are now at the toplevel. So devel:css gets translated to French on fr:devel:css. Or did I misunderstand your question?
2008-08-12 11:56:37
4
What I mean is that the translation plugin kind of chrooted us in the translation_namespace:lang_id namespace.
A [[target]] link in the 'fr' namespace used to link to 'fr:target' and not only to 'target' like it seems to be the case now.
I guess it's because of the new 'relative paths' feature. Now with the translation plugin acting too, I'm a bit lost...
2008-08-12 22:44:08
Grahack
5
I can't follow you. Have a look at http://www.dokuwiki.org/fr:manual - the first link is [[dokuwiki]] which will link to fr:dokuwiki.

The usual namespace linking rules apply to translation namespaces as to other namespaces. Nothing changed in that regard. See http://www.dokuwiki.org/namespaces for a refresher.
2008-08-12 23:32:24
6
Big kudos and thanks from my side as well for your effort! :)

I'm sorry that I couldn't lend a helping hand in this, but the weekend was reserved for some time already. :/
2008-08-13 09:30:54
CAPTCHA

No HTML allowed. URLs will be linked with nofollow attribute. Whitespace is preserved.