[Scummvm-devel] New Release (aka 0.11.0)?

Max Horn max at quendi.de
Sat Nov 17 09:46:46 CET 2007


Am 16.11.2007 um 19:21 schrieb James 'Ender' Brown:
>
>
[...]
>
>
> Anyone had a breakthrough from our Documentation group yet?

Which documentation group ??? We have none. To put it blunt, we have  
tons of people who *promised* to work on this, but zero work was done.


> *re-floats idea of building HTML documentation via Wiki to encourage
> collaboration - possibly with a open discussion page or at least  
> linked
> directly to a sub-forum..*

You mean like this: <http://wiki.scummvm.org/index.php/Documentation/ 
Manual> ? I started it ages ago, when the last time somebody  
suggested that the Wiki would solve this problem. I didn't believe it  
back then, but still made the Wiki page, hoping that people would  
prove me wrong. Unfortunately, they didn't. Even people who got Wiki  
access *specifically* to work on that part of it didn't...

However, I just noticed that it's not very well linked. Well, I'll  
place some prominent links to it and add a big "this needs to be  
enhanced" note at the top. Maybe this will improve the state of  
things. But I still doubt it :-/. Another thing: Ask for help via a  
news item.

Note that I:
* made a DocBook version of the draft,
* made a Wiki version of the manual draft,
* offered for people willing to help with the manual that they could  
use *any* format to write it or snippets, and that I would integrate  
them!,

and yet almost nothing was done. I don't think our problem lies  
here... I think the problem is that writing good docs is damn hard,  
and we just need to find 1-2 persons who really are up to it and  
*really* are willing to do it. Maybe some more advertisement would  
indeed be good. But I am against giving out accounts to random people  
just because they say they will work on it. We should do it like with  
code contributions: Provide some good patches, and you'll get access?

Bye,
Max




More information about the Scummvm-devel mailing list