[Catalog-sig] [Distutils] pypi/packages/docs.python.org

Benji York benji at benjiyork.com
Tue Mar 8 00:09:24 CET 2011

On Mon, Mar 7, 2011 at 5:52 PM, Richard Jones <richard at python.org> wrote:
> On Tue, Mar 8, 2011 at 8:06 AM, Mark Sienkiewicz <sienkiew at stsci.edu> wrote:
>> I suggest:
>> - Generate a link if there is documentation
> Right, we do this already.
>> - Generate the text "No documentation" in the place where the link would be
>> if there is no documentation.
> I don't like this. The documentation space on pypi is offered as a
> space for projects that's convenient or where they otherwise wouldn't
> be able to host their own documentation website. It's not something I
> wish to force people to use (just like package upload isn't something
> we force people to do), and stating "no documentation" would be a bit
> of a lie in a bunch of cases. Even with additional clarifying wording
> it's still a negative statement that I don't think we need to make.

What about this:

1) have some sort of "disabled" link placeholder so the documentation
   link is always there, but not an attractive nuisance leading to a
   dead end when there are no docs available and

2) let project owners provide an alternative target for the link if they
   host their documentation elsewhere.
Benji York

More information about the Catalog-SIG mailing list