Upgrade docs import non-existent modules

[chrisspen]

I'm trying to upgrade an application using Fabric 1 to Fabric 2, so that both coexist.

The docs state that both the old fabric module and fabric2 module can coexist, but this doesn't seem to be true.

Here's an MRE:

$ cat /etc/lsb-release
DISTRIB_ID=Ubuntu
DISTRIB_RELEASE=22.04
DISTRIB_CODENAME=jammy
DISTRIB_DESCRIPTION="Ubuntu 22.04.3 LTS"
$ python3.12 -m venv .env
$ . .env/bin/activate
(.env) $ pip install fabric fabric2
(.env) $ python -c "from fabric.api import env, run"
Traceback (most recent call last):
  File "<string>", line 1, in <module>
ModuleNotFoundError: No module named 'fabric.api'

If that doc page were correct, I shouldn't be getting this error.

This page goes into a little detail about how to install both packages, but not from PyPI.

Could you please clarify how to install both versions without conflicts?