Thread: wiki and math
View Single Post
wiki and math
Old
  (#1)
Pierre-Marie Baty
Roi de France
 
Pierre-Marie Baty's Avatar
 
Status: Offline
Posts: 5,049
Join Date: Nov 2003
Location: 46°43'60N 0°43'0W 0.187A
Default wiki and math - 11-02-2005

Is it just me or???

The goal of our wiki is to
  • provide bot programmers, and especially newbies and wannabe coders, the most comprehensive information center out there,
  • provide bot users with a space to contribute in their favourite bots' documentation, tips and tricks, hints etc.
That's why we have two section:
  • Programmer's section
  • Bot user documentation
Since the programmers section is targeted at the broadest audience possible, I personally try to explain things slowly, with simple code and a lot of explanation surrounding it. When the subject is too complex, I don't dig into the explanation more than necessary and I try to provide sample template code that works instead of lenghty high-level technical explanations.

But honestly, pages such as this one
http://wiki.bots-united.com/index.php/Vector_Math
are enough to make any wannabe bot coder fly away in screams! Please, please, please folks, it's not because this new wiki allows math formulas to be written easily that you must abuse it!! Remember that many of us here, and I would bet most of the wannabe coders out there are teenagers with no idea what the hell these scary formulas mean!

How do you want a teenage coder not to shit in his pants at the sight of words such as "Einstein Convention", this or this or even matrices such as ??

Is this a wiki for bot coders or for mathematicians ?

So please keep things SIMPLE, and provide coders with what they expect to find: commented code that works, instead of mathematical *****!

Or is it just me ???


*edit* ok, I removed the last word...sorry... I do not want to offense anyone... but I really wanted to raise this question

*edit 2* ok, my point: more code and less math. That's all. Thank you for your attention



RACC home - Bots-United: beer, babies & bots (especially the latter)
"Learn to think by yourself, else others will do it for you."

Last edited by Pierre-Marie Baty; 11-02-2005 at 11:44..
  
Reply With Quote