pyscaffold
Docs that mention `setup.py` need checking/updating
Description of your problem
Recently I noticed our docs still mention a lot of direct execution of setup.py, and that is now deprecated (see #535 for other details).
It would be nice to go through the docs and make sure these mentions are removed.
There are also a lot of complexity for making sure we show alternative commands when the person do not want to use tox.
That is definetely going to be removed in the next version of PyScaffold, together with the --no-tox extension. But maybe the docs can also be simplified right now? (e.g. using a disclaimer in the top of the file saying something like: "if you don't use tox, see this link for alternatives")
BTW, what's the best way to do python setup.py --version now without using setup.py?
Unfortunately there is no official answer for that yet.
Some time ago I proposed a change in setuptools-scm to address this use case, and initially it was well received by the maintainers.
But I guess they did not have the chance yet/bandwidth to go through the review process :(
Just an update on this topic: setuptools-scm has accepted the PR, now we just need to wait until they release a new version :)