[Distutils] PEP 345 - 3 new fields

[Tarek Ziadé]

On Tue, Dec 1, 2009 at 4:19 AM, Ian Bicking <ianb at colorstudy.com> wrote:
[..]
> If something more like that was added (more like Trunk-URL), that would be
> genuinely useful.  Barring that, I'd recommend removing the Repository-URL
> field from the recommendation until we have a clearer use case.  Right now,
> the better use case would be a field giving the checkout command, e.g.,:
>   Repository-Checkout: hg clone http://bitbucket.org/ianb/webob
> But I don't think that is particularly useful, only that it is more useful
> than Repository-URL.

Here's a proposal then, that seems to synthetize what people have been saying:

Let's drop "Repository-Browse-URL" and keep a single "Repository-URL"
field, which is a free
URL that can take any URL form. e.g. a browsable url, or a git/hg url etc.

Now for "Change-Log" vs "Change-Log-URL", I think the first one is
better, because
that's what people are already doing in their packages (when they add
their changelog at the
end of their long_description option), and it's not hard for PyPI to
store it and display it, besides
Description.

The value I see in that field is that:

- it helps developers structurize a bit their project description.
e.g. letting them separate
  the Description of the package from the changelog if any.

- it will let PyPI separate the front page of the project from its
changelog, e.g. in this page:
  http://pypi.python.org/pypi/zc.buildout, instead of having the
changelog here, it could be a link
  to another page for the project.

How does that sounds ?

Tarek