Update documentation for setuptools distribution #1560
pganssle left a comment
There's one typo that needs to be changed in this, but otherwise I think it can be mostly merged as-is.
I think we may want to play around with the wording of the newly added paragraphs, but that can be in a subsequent PR.
During the sprints, I suggested that we have a brief intro to the overall process on our documentation, just so people know what the general recommendation was without having to read the entire tutorial to figure out what's done.
I think that what's in this PR now is more in-depth than I was thinking, but I didn't want to nit-pick about it in this PR, I'd rather get
I'm sympathetic to this, but we don't make archived versions of the
An alternative to this would be to change RTD so that in addition to 'stable' and 'latest', there are also builds for all the minor release tags.
I'm open to removing it completely, though again I'd like to resolve this sooner rather than later, so I'm inclined to merge this (which is a clear improvement to the existing documentation), and have a second PR that trims it down.
This adds a simple introductory guide to the modern way to distribute `setuptools`-based projects with a link to the Python packaging tutorial. Rather than delete the old `ez_setup` information, it has been moved to a separate archive for people who want to use it as a historical reference.
Hm, when rebasing this against master, I realized that the move didn't include the changes from #1547. I've incorporated them into the latest version.
That may be one reason to keep these docs around for a bit longer, since we probably still do need to include information about things like