Message121399
On Wed, Nov 17, 2010 at 7:28 PM, Éric Araujo <report@bugs.python.org> wrote:
>
> Éric Araujo <merwok@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? |
|
Date |
User |
Action |
Args |
2010-11-18 01:01:10 | belopolsky | set | recipients:
+ belopolsky, georg.brandl, eric.araujo, docs@python |
2010-11-18 01:01:07 | belopolsky | link | issue10446 messages |
2010-11-18 01:01:07 | belopolsky | create | |
|