a couple initial changes to docs; also tightened up my try/catch with specific exception

--HG--
branch : 3.2
6 jobs for topic/3.2/Search in 21 minutes and 47 seconds (queued for 3 seconds)
latest
Name Stage Failure
failed
test-python311 Test
× pip subprocess to install build dependencies did not run successfully.
│ exit code: 1
╰─> See above for output.

note: This error originates from a subprocess, and is likely not a problem with pip.
WARNING: You are using pip version 22.0.4; however, version 22.1 is available.
You should consider upgrading via the '/usr/local/bin/python -m pip install --upgrade pip' command.
Cleaning up file based variables
ERROR: Job failed: exit code 1