Page 1 of 4
[Done] Moving documentation into a wiki
Posted: Thu Jul 02, 2009 11:20 am
by Wladimir Palant
I have been neglecting documentation lately, mostly because I didn't have enough time. On the other hand, I regularly have people asking me to translate the documentation into a different language - but adding more languages currently means more effort on my side every time something needs to be changed in the documentation. So I am starting thinking about a wiki that could take over the functions of Textpattern, with exception of Blog/Announcements/Development builds sections. Ideally it would be customizable in such a way that upgrades don't turn into a nightmare every time.
Does anybody have experience with a multi-language capable wiki application? I guess MediaWiki is an obvious candidate - but last time I checked it was a horrible mess.
MDC seems to have made good experience with MindTouch - yet the download of MindTouch Core contains an entire virtual machine, this might be "slightly" overdimensioned. Any other suggestions?
Posted: Thu Jul 02, 2009 12:53 pm
by jojaba
For a few years I tested Dokuwiki. It's a wiki that doesn't work with data base (all data are located in files). Long time I practice it, I should install it locally to see if it works good. If it does, then I believe the migration would be easier since you have just to copy/paste the html code of your pages in the dokuwiki pages (but i guess this should be possible in every wiki application)...
Posted: Thu Jul 02, 2009 1:00 pm
by Wladimir Palant
I don't think I want a wiki based on files - those are typically not very flexible. Also, I would like to convert Textpattern markup into the markup of that wiki - "pasting" HTML code will make the pages hard to edit. Syntax documentation of DokuWiki mentions the ability to embed HTML and PHP code directly. The idea is probably that only administrators will change pages, giving everybody that kind of power is rather risky (security-wise).
Posted: Thu Jul 02, 2009 6:26 pm
by jojaba
Do you know
Wikimatrix ? Here's the comparison of Dokuwiki and Mediawiki :
http://www.wikimatrix.org/compare/DokuWiki+MediaWiki
As you can see, Textile is supported by Dokuwiki

Posted: Thu Jul 02, 2009 10:16 pm
by ziutek
Perhaps you may wish to take a look at ikiwiki. What is very nice about it is that it is implemented at the top of a version control system (of your choice). You can manipulate the pages of the wiki directly from your vcs, with all the power that it implies.
Don't be discouraged by the ultra-spartan design of the
homepage - you can easily customize the look.
Textile is supported natively. Users include the
Cairo library,
Keith Packard, or
Monotone.
Posted: Fri Jul 03, 2009 9:10 am
by Wladimir Palant
ziutek, sounds interesting. It supports Mercurial, seems that it can sync to
http://hg.mozdev.org/adblockplus/file/tip/www/ out of the box.
Re: Moving documentation into a wiki
Posted: Mon Jan 25, 2010 11:13 am
by Wladimir Palant
TikiWiki (used by support.mozilla.com) seems to be a good candidate. On the first glance, the only real problem - it is a big system, probably too much functionality for our use case. I'll need to do a test installation to see whether this is really an issue. And of course it begs for having the forum migrated to it as well. And while I would certainly like to get rid of phpBB, migrating the forum would require significantly more effort.
PS: Going through WikiMatrix and removing wikis that didn't meet requirements only left one contender in the end:
bitweaver
Re: Moving documentation into a wiki
Posted: Mon Jan 25, 2010 4:02 pm
by Alan
Wladimir Palant wrote:And of course it begs for having the forum migrated to it as well. And while I would certainly like to get rid of phpBB, migrating the forum would require significantly more effort.
I wouldn't advise replacing the forum with anything like the Firefox Support Forums. They've been so problematic that I gave up trying to give any support there. Yeah, I know, I don't give much support here either, but your more frequent helpers may be more productive in the current one.
Re: Moving documentation into a wiki
Posted: Mon Jan 25, 2010 4:16 pm
by Wladimir Palant
The problem with the current forum -
I am not very productive here

Upgrading it takes simply too long because of all the hacks I had to add so I'll gladly dump it for something that has a proper plugin API (and maybe is even well-written to start with). Of course that will only happen if the alternative is good enough.
Re: Moving documentation into a wiki
Posted: Mon Jan 25, 2010 4:43 pm
by Alan
Oh, I hadn't realized administrating/upgrading phpBB had become problematic. I'm sorry I don't have any expertise which could be helpful. I hope you're able to find an alternative which is less time-consuming.
Re: Moving documentation into a wiki
Posted: Mon Jan 25, 2010 6:25 pm
by Michael
Why don't you ask someone with technical knowledge and spare time to deal with the forum software? You would then be free to deal with the posts.
Re: Moving documentation into a wiki
Posted: Mon Jan 25, 2010 8:46 pm
by Wladimir Palant
I am somewhat wary of giving anybody permission to upload code to my server. On the other hand, this isn't impossible if a good candidate is found. So far
nobody stepped up (granted, this post is way too long and possible candidates most likely didn't even read to that point).
Re: Moving documentation into a wiki
Posted: Wed Jan 27, 2010 12:42 pm
by Wladimir Palant
Btw, I took a look at bitweaver yesterday. From what I can tell, it is modular and the code is reasonably clean. However, it has a relatively small group of contributors who don't seem to have much time for further development. Also, my first impression was that user interfaces don't get proper treatment, not the most user-friendly solution you can imagine. TikiWiki on the other hand is being very actively developed with Mozilla contributing as well. User interfaces are ok (again, first impression). However, the code base is monolitic which is very scary with that amount of functionality. Also, code quality varies throughout the project and I am scared by the number of buzzwordy abstraction layers they are using (in the end it has to run on this server without using too much of its resources).
Re: Moving documentation into a wiki
Posted: Thu Feb 18, 2010 5:19 pm
by Wladimir Palant
I stumbled upon
Anwiki today. I don't know why it fell through when I checked WikiMatrix results - it looks very promising, exactly what we need. Clean and simple code, no unnecessary features, strong support for easy maintenance of multiple language versions. Good extensibility, adding any features we need shouldn't be a problem. I'll try installing it and importing existing content.
Re: Moving documentation into a wiki
Posted: Fri Feb 19, 2010 1:12 pm
by alberto
It looks that Anwiki entry was only recently added to WikiMatrix (20th Jan), so that may explain why you missed it.
Anwiki does not seem to have many contributors and support community, but certainly the features provided (e.g. auto sync) look very promising.
Was wondering if you have looked at sites that are already using Anwiki to see few examples?