align docs correctly
Enhanced installation instructions.

Motivation is to make use these same instructions also as INSTALL.rst
in project root (#1779).

Changes done now:
- Drop references to One Click Installer (only worked on XP) and
  already removed non-standard install.py script (#1753).
- List using pip as the first and most recommended installation approach.
- General clean-up.