Have you guys explicitly laid out the documentation style conventions? I was looking for something similar to <a href="http://dev.mysql.com/doc/refman/5.5/en/manual-conventions.html" target="_blank">http://dev.mysql.com/doc/refman/5.5/en/manual-conventions.html</a> but I couldn't find it. When I asked about this on the IRC channel, I was referred to 4.7 of the tutorial, which talks only briefly about documentation and mostly related to source code documentation. I would expect it to be discussed at <a href="http://docs.python.org/about.html" target="_blank">http://docs.python.org/about.html</a>. <br>

<br>The brackets [] around optional parameters is pretty standard, so even a newbie like me understood it (altho I still think it should be disclosed), but when I read <a href="http://docs.python.org/release/3.1.5/library/csv.html" target="_blank">http://docs.python.org/release/3.1.5/library/csv.html</a> I noticed that csv.reader has optional parameters which are not bracketed, which confuses me a bit. I'm talking about <i>dialect='excel'</i>, <i>**fmtparams</i>. I'm also not sure what ** means (I'm guessing multiple parameters?) or just a single * means.<br>

 <br>