RE: [Python] Re: PyPI question, or, maybe I'm just stupid

Path	csiph.com!usenet.pasdenom.info!gegeweb.org!de-l.enfer-du-nord.net!feeder1.enfer-du-nord.net!feeds.phibee-telecom.net!newsfeed.xs4all.nl!newsfeed6.news.xs4all.nl!xs4all!post.news.xs4all.nl!not-for-mail
Return-Path	<ramit.prasad@jpmorgan.com>
X-Original-To	python-list@python.org
Delivered-To	python-list@mail.python.org
X-Spam-Status	OK 0.000
X-Spam-Evidence	'H': 1.00; 'S': 0.00; 'subject:: [': 0.03; 'subject:Python': 0.05; 'modify': 0.05; 'sufficient': 0.05; 'not': 0.07; 'completeness': 0.07; 'subject:question': 0.08; 'api': 0.09; 'received:155': 0.09; 'subject:PyPI': 0.09; 'bug': 0.10; 'commit': 0.15; 'conflicted': 0.16; 'disclaimers': 0.16; 'disclaimers,': 0.16; 'from:addr:jpmorgan.com': 0.16; 'guess.': 0.16; 'memo': 0.16; 'personally,': 0.16; 'received:155.180': 0.16; 'received:155.180.234': 0.16; 'received:159.53': 0.16; 'received:bankone.net': 0.16; 'received:exchad.jpmchase.net': 0.16; 'received:jpmchase.com': 0.16; 'received:jpmchase.net': 0.16; 'received:svr.bankone.net': 0.16; 'refactored': 0.16; 'sdist': 0.16; 'securities,': 0.16; 'url:disclosures': 0.16; 'url:jpmorgan': 0.16; 'why,': 0.16; 'users.': 0.16; 'fix': 0.17; 'subject:] ': 0.19; 'to:name:python-list@python.org': 0.20; 'developers.': 0.22; 'modifying': 0.22; "i've": 0.23; 'received:169.254': 0.24; 'feature': 0.24; 'header:In-Reply-To:1': 0.25; 'developers': 0.26; 'accuracy': 0.27; '(maybe': 0.29; 'thus,': 0.29; 'received:169': 0.29; "i'm": 0.29; 'maybe': 0.29; 'header:Received:8': 0.30; 'code': 0.31; 'could': 0.32; 'page.': 0.33; 'handle': 0.33; 'to:addr:python-list': 0.33; 'point.': 0.33; 'changed': 0.34; 'something': 0.35; 'there': 0.35; 'add': 0.36; 'but': 0.36; 'charset:us-ascii': 0.36; 'available.': 0.37; 'subject:: ': 0.38; 'some': 0.38; 'page': 0.38; 'description': 0.39; 'to:addr:python.org': 0.39; 'skip:" 10': 0.40; 'think': 0.40; 'your': 0.60; 'subject:, ': 0.61; 'leaving': 0.62; 'details': 0.63; 'information': 0.63; 'information,': 0.63; 'url:email': 0.63; 'legal': 0.65; 'subject': 0.66; 'finally': 0.66; 'purchase': 0.67; 'user,': 0.69; 'carefully': 0.71; 'hoping': 0.72; 'sale': 0.76; 'aaa': 0.84; 'received:169.254.8': 0.84
X-DKIM	OpenDKIM Filter v2.1.3 sf3.jpmchase.com q6UIlwSw018473
DKIM-Signature	v=1; a=rsa-sha256; c=relaxed/relaxed; d=jpmorgan.com; s=smtpout; t=1343674078; bh=IYEbHy9/LSgQLr8WPejid32ks9h/TMwoKiKCSr6zExY=; h=From:To:Subject:Date:Message-ID:References:In-Reply-To: Content-Transfer-Encoding:MIME-Version:Content-Type; b=hdFVy71pxIu3Bn0GHb/brK3S4noXp3+SxXUNmcJfQ2t1AWB0fYh+2bGeDZqgPYVS0 9sCMhC61/jgwkDOrsNxH9cqRVN+49O+bPb43uQYJ8SFu6x3HayNoAzjZkkixJtlzgS C7ZGm8rDGKov/6RDKbENcQKao/8Q/yXV4TFKvCWo=
From	"Prasad, Ramit" <ramit.prasad@jpmorgan.com>
To	"python-list@python.org" <python-list@python.org>
Subject	RE: [Python] Re: PyPI question, or, maybe I'm just stupid
Thread-Topic	[Python] Re: PyPI question, or, maybe I'm just stupid
Thread-Index	AQHNblHtkY3GiZZ/L0erS9MdQjXNxJdCKDLA
Date	Mon, 30 Jul 2012 18:47:42 +0000
References	<50168312.6080900@gonnerman.org>
In-Reply-To	<50168312.6080900@gonnerman.org>
Accept-Language	en-US
Content-Language	en-US
X-MS-Has-Attach
X-MS-TNEF-Correlator
x-originating-ip	[10.67.79.47]
Content-Transfer-Encoding	quoted-printable
MIME-Version	1.0
X-DLP-FWD	Yes
Content-Type	text/plain; charset="us-ascii"
X-BeenThere	python-list@python.org
X-Mailman-Version	2.1.12
Precedence	list
List-Id	General discussion list for the Python programming language <python-list.python.org>
List-Unsubscribe	<http://mail.python.org/mailman/options/python-list>, <mailto:python-list-request@python.org?subject=unsubscribe>
List-Archive	<http://mail.python.org/pipermail/python-list>
List-Post	<mailto:python-list@python.org>
List-Help	<mailto:python-list-request@python.org?subject=help>
List-Subscribe	<http://mail.python.org/mailman/listinfo/python-list>, <mailto:python-list-request@python.org?subject=subscribe>
Newsgroups	comp.lang.python
Message-ID	<mailman.2745.1343675234.4697.python-list@python.org> (permalink)
Lines	22
NNTP-Posting-Host	2001:888:2000:d::a6
X-Trace	1343675234 news.xs4all.nl 6929 [2001:888:2000:d::a6]:41862
X-Complaints-To	abuse@xs4all.nl
Xref	csiph.com comp.lang.python:26271

Show key headers only | View raw

> > However, personally, I am not interested in all the details (typically
> > found in "CHANGES.txt") but some (often implicit) information is
> > sufficient for me: something like "major API change", "minor bug
> > fixes". Thus, think carefully what you put on the overview page.

> I see your point.  I'm just lazy, I guess.  I already put a description
> of what I've changed into git, so why, I muse, must I also edit the
> overview page separately?  I was hoping there was an automatic way that
> "setup.py sdist upload" could handle it for me.

Even if you could include commit messages I would not recommend it.
Commit messages are for developers of _your_ package not users. It is
like leaving a memo (cough or message) for future developers.

As a user, I want to know that you added a feature AAA. I do *not*
want to know that in order to add AAA you also had to modify BBB
and create CCC. Maybe you had to revert BBB because it conflicted
with DDD and then you refactored some code and added/updated
comments. Finally you managed to fix BBB (maybe also modifying DDD?)
and so the feature AAA is now available.  


Ramit

This email is confidential and subject to important disclaimers and
conditions including on offers for the purchase or sale of
securities, accuracy and completeness of information, viruses,
confidentiality, legal privilege, and legal entity disclaimers,
available at http://www.jpmorgan.com/pages/disclosures/email.

Back to comp.lang.python | Previous | Next | Find similar | Unroll thread

Thread

RE: [Python] Re: PyPI question, or, maybe I'm just stupid "Prasad, Ramit" <ramit.prasad@jpmorgan.com> - 2012-07-30 18:47 +0000

csiph-web