let's get rid of trivia comments

[Markus Gattol]

One thing I noticed right away with Colony's codebase is that it has a
lot of comments which are completely unnecessary and actually more of
a distraction rather than helpful http://goo.gl/OM9GQ


Example:
... /colony/colony/base/plugin_system.py
class Event
def is_event_or_sub_event(self, event)
...
# returns true <--- really? (that's
just one example)
...

I'd fire something like this sed -i 's?# returns true??g' * at the
codebase to rid of all that trivia cruft. We're all smart enough to
read/understand the codebase so let's nuke those kinds of comments :)

[João Magalhães]

That's a long story and more a hive story than a colony one.
When you try to establish order and organization in your codebase it is sometimes difficult to control and set a border between what's is necessary what's not.
The fact is that I can't get you a good reason for that kind of comments to exist but I can't remove them in an easy manner (without compromising the beauty of the code).
Probably 90 % (or more) of the framework code is self-explainatory (just with code), but still it is commented for aesthetic purposes. Maybe the best solution is to remove the comments during build automation.
For us is not a real problem, but I understand your point of view as it's not common or usefull :)

[Markus Gattol]

No problem here either but stuff like #return true followed by a line
of return True has nothing to do with having a sane coding style/
convention that everybody in the community/team adheres to (which I am
+1 on), it's just superfluous :-)