document how a python project should document installing itself

Right now, many many projects on PyPI document their install process as sudo pip install. This is (obviously, I hope) suboptimal.

How should projects document their installation process? It's tempting to say "just pip install", but this falls apart if:

1. the user doesn't have a C compiler, but the project has a C extension
2. the user doesn't have the right version of a C compiler (for example: matching up Windows compiler versions to Python versions)
3. the project has native dependencies outside their platform's base installation package (libffi, libssl, libcrypto being popular ones, but more esoteric libraries like gtk, libpng, imagemagick, and so on also cause interesting issues)
4. the user isn't root, doesn't have an awesome pip configuration and doesn't know about virtualenv

There's also the issue that if you use platform packages, you get automatic security updates (at least sometimes) but there doesn't appear to be any generally acknowledged "best practices" for getting security updates with pip. There isn't even any standard security-update-notification mechanism I'm aware of. Is it even possible to get PyPI to send you an email when new versions of a thing are released?

However, putting a dissertation into every project's documentation about how to install pip, virtualenv, apt, yum, nuget, homebrew, ebuild, nix, and seven other package managers is unlikely to result in a positive user experience.

Getting to the point where projects no longer have mutually contradictory documentation that provides a good experience is likely to be a long slog, but it seems like this guide should provide a starting point that projects can begin linking to so that users can get some quickstart instructions which work almost all of the time, and can have a good central reading list for understanding the subtleties associated with different ways that packages can be installed.

Inizia esaminando gli scenari di installazione elencati nell’issue, inclusi compilatori, dipendenze native, utenti non-root, virtualenv, pacchetti della piattaforma e aggiornamenti di sicurezza. Usa come contesto la risorsa collegata sulla configurazione di pip e la lista di lettura centrale proposta nell’issue. Il lavoro sarà considerato completato quando sarà prodotta una guida concordata con istruzioni pratiche per il quickstart e indicazioni chiare sui compromessi relativi all’installazione e agli aggiornamenti.