GNOME Bugzilla – Bug 302182
Documentation should be included on the Web site
Last modified: 2005-07-12 20:55:46 UTC
Pretty simple idea, an up to date copy of the documentation should be included on the Web site. You already have a whole lot of content and descriptions and it makes sense to put it up where users can easily access it and get a better understanding of what the software does before downloading it.
I've had a think about this. The answer is no, for several reasons. The first is that keeping the documentation up to date either requires me updating it at each release - something I'm not good at - or hooking directly into CVS, which brings its own problems with documentation only reflecting the most recent (and probably unreleased) code. The second is that the documentation doesn't do a good job of giving people a good overview of the games. I have tried to present a brief overview of each game on the web-page (suggestions on how to improve this are welcome) and this should be sufficient. People do not need detailed documentation to make their gaming decisions. Thirdly, most people get gnome-games as part of a default installation. Very few people decide to get it themselves in the first place. Putting the documentation in some obscure place online isn't going to change much.
http://bugzilla.gnome.org/show_bug.cgi?id=306311 library.gnome.org proposed doing this on a much larger scale once i sat down and thought about it I realised the complexity of getting this working (many languages many versions ...) and the effort required to keep it running. while I'd still like to see Library.gnome.org happen it doesn't make much sense for Gnome Games to try and does this in isolation.