On 5 November 2015 at 19:51, Thomas Güttler
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. Paul