Alexander Belopolsky <belopol...@users.sourceforge.net> added the comment:
On Wed, Nov 17, 2010 at 7:28 PM, Éric Araujo <rep...@bugs.python.org> wrote: > > Éric Araujo <mer...@netwok.org> added the comment: > > Looks good. Some remarks: > > 1) I assume you have checked that this code does not produce two newlines > (one in the string, > one from the print function or write method): Yes, it should be clear from the output that I presented above. I think TextDoc.indent() takes care of the trailing '\n'. That won't work for maintenance branches. (I am not even sure docs are built for maintenance branches.) > 3) People seem to go the the most recent version of the docs, not the > release-specific version > (I haven’t found the python-dev thread about that, maybe you remember it). > The version{add,chang}ed directives help adjust the doc for older versions. > So, are you sure it’s useful to make the links release-specific? Certainly. If we are talking about the most authoritative source. I don't think versionadded/changed tags are reliable enough and you don't want to send users to wrong docs when APIs change between releases. I am not so sure about micro-version, but there is no easy way to construct the latest micro-version link without changes on python.org. If there was say latest/X.Y, I would use that. Wait - there is: docs.python.org/X.Y. Would you prefer that? ---------- _______________________________________ Python tracker <rep...@bugs.python.org> <http://bugs.python.org/issue10446> _______________________________________ _______________________________________________ Python-bugs-list mailing list Unsubscribe: http://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com