[Epic] Rename "docker-py" to "Docker SDK for Python" #1310
Description
Proposal
As part of a wider initiative, we're creating some properly supported SDKs for the Engine API.
docker-py was the first official-ish library, all that time ago. Go is now the second. However, if we're going to continue to create ones for other languages, it'd be nice if they had consistent naming, roughly consistent APIs, and so on. It is also helpful to be able to refer them as a collective product, rather than the wishy-washy "client libraries for the Engine API".
Hence, the "Docker SDKs". Each particular language will be "Docker SDK for X": Docker SDK for Python, Docker SDK for Go, etc. There will be centralised documentation with a getting started guide for multiple languages (and curl!), which link off to each library's respective reference documentation.
Tasks
- Make it really clear that "docker-py" is now "Docker SDK for Python". All old URLs should redirect, all landing pages should mention that it has renamed, and so on.
- Replace all mentions of "docker-py" in the source code with "Docker SDK for Python" or "docker-sdk-python". Start to rename docker-py to docker-sdk-python #1315
- Move the GitHub repository to docker/docker-sdk-python. (Update Travis, Jenkins, etc, too.)
- Move the documentation to https://docker-sdk-python.readthedocs.io. Ensure the old documentation redirects correctly.
- Fix all URLs that have changed above in source code and docs. Rename all meaningful occurrences of docker-py to docker-sdk-python #1332
- Release 2.0 as the PyPi package "docker", not "docker-py". "docker-py" will remain for 1.x.