[Distutils] The Update Framework, integrate into PyPI?

Paul Moore p.f.moore at gmail.com
Thu Nov 5 15:43:29 EST 2015

On 5 November 2015 at 19:51, Thomas Güttler
<guettliml at thomas-guettler.de> wrote:
> My guess is that 99% of all new comers get confused by the current docs.

My guess (no more or less accurate than yours!) is that very few new
users read the docs. Maybe they get confused by the UI of the tools,
maybe not. But improving docs they don't read wouldn't help as much as
improving the UI.

And anyway, the document you asked about is aimed at people wanting to
help with developing the packaging tools, *not* at end users.

> Somehow I have the need to speak it out. I have no clue how to improve it. That's why I ask here.
> If you don't like my question ... sorry they are just a mirror of the current state of the docs.

But you don't ask questions with any goal in mind - you're not saying
"I want to do X and I can't find the information I need". You just ask
questions about random things, with no explanation of what actual work
you are trying to do that the information would help you achieve. (And
no, "understand Python's packaging" isn't actual work - "install
package X" is, as is "write a PR for pip to do X".)

> For me the basic docs are more important than the "important improvements".

Understood. Your opinion is noted. Many people here disagree with your
priorities (at least in terms of what they wish to contribute) -
although there *are* people working on the tutorial documentation, so
your implication that nobody's doing what you want them to is wrong.

The tone of your emails seems consistently critical. I'm willing to
assume that you're frustrated and wish you could find a way to help,
but it's getting hard to remain patient. Please could you try to
phrase your questions in future with a bit more thought to the fact
that the software you're commenting on was provided free of charge by
people working in their spare time. Developer enthusiasm is hard to
obtain, and very easy to lose, so needs to be treated with respect.


More information about the Distutils-SIG mailing list