2009/5/4 Damian Conway <dam...@conway.org>: > > Each approach has advantages and disadvantages. > Feedback via this forum would be most welcome. >
Most people seem to lean towards the pod comments, though I disagree with it on a simple ground: aesthetics. Python docstrings aren't just useful, they are reasonably pretty too, #={} isn't. In fact I'd say it's pretty fugly. I think that a feature that we intend to be used often should be more aesthetically pleasing, if only to promote its use. Leon