I think this comment makes a lot of sense.

We should update our docs to recommend pip install . where appropriate. We can't (and shouldn't) explicitly disallow setup.py install, but most users will have a better time of it using pip to install from source in this day and age.