Am 24.11.2010 22:23, schrieb skip@pobox.com:

Georg> at <http://dpo.gbrandl.de/contents>, you can look at a version of Georg> the 3.2 docs that has the upcoming commenting feature.

Very cool.

Thanks!

Georg> Any feedback is appreciated (I'd suggest mailing it to doc-SIG Georg> only, to avoid cluttering up python-dev).

It would be nice if you could "invert" things and show comments with links back to the pages/blocks where those comments were made. That would seem to be useful for a documenter who wants to know where all the comments are. Unless you have some hidden interface it seems like you just have to navigate to every page and look for bubbles.

Yes, that's definitely one thing I had in mind for the moderator side. I'm leaning toward the "don't keep comments endlessly, but fold back good suggestions into the main text" side of things, so a good view of "things to do" is definitely needed. Georg