Hi Michael, On Tuesday 17 April 2007 12:24:41 am Michael Edwards wrote: > The errors which I have been made aware of have been fixed in the wiki. > Other folks may have fixed some as well. Anyone who wants is very welcome > to contribute to the documentation. If you want to make sweeping changes, > it would be nice if you let folks know, but as you say they do need a bit > of work.
How I can edit wiki pages? I suppose I need a login. > The docs are part of the official release and I believe from my > understanding of our release policies, we can't cut another "release" > without beta testing. Perhaps we should make a separate oscar-docs tar > since we already have so many tarballs already, one more won't hurt? Then > we can just update the docs whenever it is sensible to do so without having > to fiddle around in the release tree? I think fixing errors in the documentation (as opposed to expanding/changing it dramatically) is part of a normal maintenance process. Perhaps, packaging documentation separately is a good idea. Although it may confuse users even more ;-( > My original intent was that the release docs would be frozen like the other > code and simply refer people to the wiki. But then I figured people would > likely find the wiki first and use that, but it doesn't seem to be the > case. I'd rather put wiki link under the Documentation section of OSCAR site, not Resources. I believe this has been already suggested... > If folks still prefer using the pdfs, we could go back to the laTex > version, which lacks the formating issue of the automagically generated pdf > which is still quite rough. Those are just somewhat more involved for > arbitrary people to edit. But not too many people are editing the wikis > either, so perhaps it is not much different. PDFs are nice because they are easy to print. One not always have a spare monitor attached to a computer with internet access and a browser while sitting in a server room in the basement... --Ivan ------------------------------------------------------------------------- This SF.net email is sponsored by DB2 Express Download DB2 Express C - the FREE version of DB2 express and take control of your XML. No limits. Just data. Click to get it now. http://sourceforge.net/powerbar/db2/ _______________________________________________ Oscar-users mailing list Oscar-users@lists.sourceforge.net https://lists.sourceforge.net/lists/listinfo/oscar-users
