Ian Bicking: the old part of his blog

Python doc comments comment 000

It can be difficult for the layout. They should just extend downward, but it gets bad when there's lots of comments on one paragraph, and then a comment on the next paragraph. That's ugly. The folded view might be better, or maybe some overflow thing, or otherwise combining comments. Really long comments (which can be very useful) will also cause these problems.

I also want to add a better interface for commenting on the entire page, probably presented as a simple list of comments at the end of the page. Or maybe threaded.

Comment on Re: Python Documentation Comments
by Ian Bicking