Documentation should stop suggesting `pip install --user`
This installation method will fail on distributions that mark themselves as "externally managed" following PEP 668. As I write this that's Debian 12 and Ubuntu 23.04. Others are expected to follow.
The best replacement is probably:
python3 -m venv DIRNAME DIRNAME/bin/pip install PKGNAME
… and then run the software from
DIRNAME/bin, either explicitly, using
$PATH, a symlink from