[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