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

cool-RR cool-rr at cool-rr.com
Sun Mar 6 22:08:25 CET 2011


2011/3/6 Tarek Ziadé <ziade.tarek at gmail.com>

> 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..
>
>
+1


Ram
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.python.org/pipermail/distutils-sig/attachments/20110306/7742e120/attachment-0001.html>


More information about the Distutils-SIG mailing list