The guide should suggest upgrading pip (i.e., running pip install -U pip) before running any other pip command. Pip 20.3 includes some pretty important changes that make installation more robust. (See also discussion and comparison to conda on Wikipedia.)
Right now, conda is being used as a virtualenv replacement, but it is really a replacement for both virtualenv and pip. Even more robust might be to adopt conda entirely (though we should try to implement the above point to improve pip usage first). The conda equivalent of pip install -r requirements.txt is conda install --file requirements.txt. See Using Pip in a Conda Environment for a discussion of the downsides of mixing conda and pip.
Right now, the guide does not specify how to start up a jupyter server for running and editing the notebooks locally, leaving it to the user to figure out how to do so. It would be nice to spell this out, or to point them to a guide that demonstrates this generally.
Reviewing the installation guide (which might soon change locations), I noticed a few things and have some suggestions:
pip install -U pip
) before running any other pip command. Pip 20.3 includes some pretty important changes that make installation more robust. (See also discussion and comparison to conda on Wikipedia.)pip install -r requirements.txt
isconda install --file requirements.txt
. See Using Pip in a Conda Environment for a discussion of the downsides of mixing conda and pip.