[issue10446] pydoc3 links to 2.x library reference
Alexander Belopolsky
report at bugs.python.org
Thu Nov 18 02:01:10 CET 2010
Alexander Belopolsky <belopolsky at users.sourceforge.net> added the comment:
On Wed, Nov 17, 2010 at 7:28 PM, Éric Araujo <report at bugs.python.org> wrote:
>
> Éric Araujo <merwok at 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 <report at bugs.python.org>
<http://bugs.python.org/issue10446>
_______________________________________
More information about the Python-bugs-list
mailing list