Partially addresses #397, specifically:

Then I read the instructions again, tried pip3_import, which doesn't exist (under pip.bzl). ...

pip3_import is legacy now and not provided in python/pip.bzl, so shouldn't be commented as an alternative to pip_install.

cc @dayfine

PR Checklist

Please check if your PR fulfills the following requirements:

• Does not include precompiled binaries, eg. .par files. See CONTRIBUTING.md for info
• Tests for the changes have been added (for bug fixes / features)
• Docs have been added / updated (for bug fixes / features)

PR Type

What kind of change does this PR introduce?

• Bugfix
• Feature (please, look at the "Scope of the project" section in the README.md file)
• Code style update (formatting, local variables)
• Refactoring (no functional changes, no api changes)
• Build related changes
• CI related changes
• Documentation content changes
• Other... Please describe:

Does this PR introduce a breaking change?

• Yes
• No

Other information