Currently, documentation is only available on the wiki, thus an Internet connection is needed to lookup any detailed information about UseBB. The couple of docs that come with UseBB are a simple INSTALL and UPGRADE document. I can imagine this is far too less for a decent project.
That's why I have been thinking of making official documentation by people from a seperate documentation team (and developers), storing the docs on our CVS repository. This would make it possible to: a) manage them in a more standardised format (XML or HTML in opposition to the wiki syntax); b) pack the latest documentation together with UseBB; c) don't give vandals any change of altering data. A disadvantage is that other people won't be able to edit official documentation themselves (to fix errors or typos or give additional info), thus will need to contact the doc team (directly or via a tracker/forum). To give people the opportunity to make their own HOWTO's etc, a seperate forum/tracker/whatever could be set up, or a third party website could be used for this (at least one resource website is under construction).
I think this is a decent solution for the documentation problem we are coping with right now. To clear things up I made the following chart with the current and future(?) situation: http://users.telenet.be/pc_freak/diversen/usebb-docschanges.png.
I need feedback on this! So please reply to the thread with your remarks or ideas: http://www.usebb.net/community/topic-692.html.
Thanks in advance.
_______________
« Last edit by Dietrich on Fri Oct 21, 2005 6:51 pm. »
