> After all, from what I've seen since then, the practice of > triple-quote-commenting (or TQC, pardon the TCA) is in fact quite > common. > > Is TQC OK after all? > > If not, what's the case against it?
I have no sense of how approved it is, and don't have a strong opinion on it, but I would think that some cases against it could be: - It's used for docstrings, so when you scan code it is harder to instantly find comment blocks or docstrings if IDE parsers color code comments differently than docstrings. An IDE I use (Boa Constructor) uses "# XXX [comment]" as a comment that means "add to the to-do list" as well. - If you want to search for comments easily, you can search for #, which will probably only bring you to comments, whereas if you search for quote marks, they could be used in a number of different ways in the code. - Adhering to coding conventions is a good thing in open source applications. -- http://mail.python.org/mailman/listinfo/python-list
