[Distutils] pypi/packages/docs.python.org

[Tarek Ziadé]

On Sun, Mar 6, 2011 at 9:42 PM, "Martin v. Löwis" <martin at v.loewis.de> wrote:
>> One thing I find weird is the root page of packages.python.org -- This
>> warning is not super user friendly.
>
> What particular clause strikes you as particularly unfriendly?
> Please understand that it may sound harsh, but is necessary - better
> be safe than sorry.

Nothing wrong about the warning itself, but about landing on a plain
condensed text page.
I think we should make it a html page. And maybe display the last ten
packages doc updates ?

>
>> That said, maybe projects documentation could simply be displayed
>> under their pypi.python.org/pypi root page,
>> and packages.python.org made an alias to pypi.python.org
>
> Not sure I understand the proposal. What URL would distribute
> get (say)? (i.e. what is distribute's "pypi.python.org/pypi
> root page"?) If "http://pypi.python.org/pypi/distribute", what
> would you do with the content that is currently displayed there?

so Distribute has currently:  "http://pypi.python.org/pypi/distribute"

It's the Description field of the metadata.

And then we push our doc at: "http://packages.python.org/distribute/"

Since "packages.python.org" allow us to have a directory with HTML
files, those could be made accessible under:

http://pypi.python.org/pypi/distribute/docs, with a big link on the
top of http://pypi.python.org/pypi/distribute to go there.

So:

http://packages.python.org/PROJECT/  would become
http://pypi.python.org/pypi/PROJECT/doc

IOW, not changes but just avoiding two places -- without giving any
hint on each place about the existence of the other place.

Why Distribute would have two root pages ?
http://pypi.python.org/pypi/distribute is a fine one


Then, maybe http://pypi.python.org/pypi could simply become
http://packages.python.org, with:


- http://packages.python.org/PROJECT
- http://packages.python.org/PROJECT/docs
- http://packages.python.org/PROJECT/1.2
- etc..


>
> Regards,
> Martin
> _______________________________________________
> Distutils-SIG maillist  -  Distutils-SIG at python.org
> http://mail.python.org/mailman/listinfo/distutils-sig
>



-- 
Tarek Ziadé | http://ziade.org