This is more a philosophical question and one of personal oppinion.
The first part was reformatting, for human-readability and changing
to doxygen commenting style, for later use if wished, since the part
below with @params is already in doxygen style. For consitency if you
like. ;)
The part
- """Load history informations by API query. """
+ # Load history informations by API query.
was due to the fact that """...""" IS NOT A COMMENT BUT a
function
description IF PUT RIGHT AFTER THE HEADER, but not "in the middle of
nowhere"... :)
Greetings!
Am 13.11.2010 15:41, schrieb BinĂ¡ris:
Hi,
could you please explain to a beginner, why is this good?
--
BinĂ¡ris
_______________________________________________
Pywikipedia-l mailing list
Pywikipedia-l(a)lists.wikimedia.org
https://lists.wikimedia.org/mailman/listinfo/pywikipedia-l