[Doc-SIG] [Python-Dev] [Preview] Comments and change proposals on documentation

[Georg Brandl]

Am 24.11.2010 22:23, schrieb skip at 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