[Python-ideas] docs.python.org: Short URLs

[Ryan Hiebert]

On Mon, Feb 17, 2014 at 11:25 AM, <random832 at fastmail.us> wrote:
>
>
> I don't know why they should be redirects, no. I think what's being
> proposed in the article _was_ a separate page for every class and every
> function. PHP does that. .NET does that. Why shouldn't Python? Is it
> possible that the Python documentation suffers from excessive
> conciseness _because_ everything's on one page?
>
> I don't know that it's necessarily because everything is on one page, but
I could imagine that it's a contributing factor to why things are concise,
and I could see that splitting things up into more pages would encourage
longer prose and more examples. Longer isn't always better, but sometimes
saying things multiple ways can help the message get across.
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.python.org/pipermail/python-ideas/attachments/20140217/9fe20177/attachment.html>