As a Python dev, installing tools like poetry with pipsi makes for a very convenient experience. However, the interaction between the currently available pipsi on PyPI and how poetry makes broken virtualenvs. This has been noted in a couple of poetry GitHub issues already.

A note in the poetry documentation, that describes installing via pipsi, and how to handle the resulting broken envs, would be helpful for users wanting to install that way. While partially off topic (since the problem really isn't with poetry) it adds real value to the documentation.

See also:

• Poetry fails to install on macOS High Sierra using Homebrew Python 3 #59
• Venv is created without pip #169