[Doc-SIG] [Python-Dev] [Preview] Comments and change proposals on documentation
Georg Brandl
g.brandl at gmx.net
Thu Nov 25 08:30:20 CET 2010
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
More information about the Doc-SIG
mailing list