Deprecate `setup.py docs`, suggest and use replacement `buildconfig/makeref.py`

[ankith26]

trafficstars

This is another small step in our move away from setup.py.

python setup.py docs internally executes python buildconfig/makeref.py, so this PR makes the straightforward replacement.

Should also help fix the fails in #2850