Re: [simspark-devel] [Sserver-three-d] Documentation

[Drew N. <dre...@ya...>]

Hi Samuel,

By all means, if you find an area of the wiki that could be improved by perhaps adding more information, questioning things that seem incorrect, updating examples/screenshots, or even removing duplicated information, go for it!  If you're new to the project, then you have a unique perspective on the documentation. What would have been easier for you, or more useful, while you were learning SimSpark/rcssserver3d?


Also, every article on the wiki has its own discussion page upon which questions or half-baked ideas can be posted, if you don't think they're ready or appropriate for the main article just yet.

Some ideas for areas of the wiki that could be improved:
	* The screen shots on this page are a bit out of date, for example http://simspark.sourceforge.net/wiki/index.php/Running_a_Simulation.  They show the old Soccerbot model.  The actual images should have replacements uploaded.  Unfortunately I've been messing around with the textures and models in my simulator, so mine looks even less like the current release!
	* Another area that could be improved is visibility on ideas and improvements in the pipeline for the project. This page currently links to four other pages, each of which have some kind of todo list on them.  It might be nice to pull all these into one area, and invite people to discuss/add/endorse there.  Perhaps there's an issue tracker for this already, but wikis are still amenable to this if the volume isn't too great.
	* We could add a Hall of Fame that shows which teams placed in previous competitions.
	* Several pages have TODO markers that indicate places where the documentation could be improved. You could try and answer some of these, and even add your own in places where you think it isn't clear. Unfortunately searching the Wiki for TODO returns the page with that name, so you can use Google: http://www.google.com/search?q=site:simspark.sourceforge.net+TODO
I realised as I wrote this that the list should probably go on the wiki iteself, so check this page for ideas to solve, or add your own:

http://simspark.sourceforge.net/wiki/index.php/Todo

Have fun!

Drew.



________________________________
From: Samuel Russell <ro...@ho...>
To: Joschka Boedecker <jos...@am...>
Cc: Drew Noakes <dr...@dr...>; sse...@li...; sim...@li...
Sent: Sat, 26 June, 2010 2:25:11
Subject: Re: [Sserver-three-d] [simspark-devel] Documentation

Hi Drew

I'm new in 3d simulation but if you need some help you can count on me,
It's my pleasure to assist you.
And thanks for your improve WIKI page.

Best Regards
    Esmaeil Mirzaee(ronin3d)