[MRG] Install doc update

Refactored and update the installation documentation to give per-OS instructions.
Yes it's confusing to advertise 2 competing methods and pip is now maintained and shipped by default by the Python core developers.