Docs version 'latest' missing changelog entries for 2.x about py-amqp

[pquentin]

There's also a confusion between http://py-amqp.readthedocs.io/en/latest/ and https://amqp.readthedocs.io/en/latest/.

[ask]

@edmorley RTD latest is now changed to use the 2.0 branch,
and the README was rendered from source to fix the wrong version.

@pquentin I cannot find references to http://py-amqp.readthedocs.io anywhere?

[pquentin]

@ask The situation is quite confusing between all the RabbitMQ/AMQP libraries. The first thing I saw about py-amqp is that it's a "amqplib fork" but I have no idea what amqplib is. (I found it now but the first thing I saw about "amqplib" is a Node.js library.) Maybe it's time to position the library differently: saying what it does well, not what it does differently.

The other issue is that it's the first time I see a project use a different name on RTD and GitHub. This is why I wondered "does py-amqp.readthedocs.io exist ?". It also comes up if you look up "py-amqp readthedocs" on Google Search. I understand that "amqp" is the source of truth since the name on PyPI is the most difficult to change. With such a generic name, confusion is bound to happen, so it would be nice to try to reduce it as much as possible. One option is 1/ changing the name on Github to amqp 2/ removing py-amqp.readthedocs.org.

[ask]

@pquentin The purpose of this project is to be generic, but it's created out of the needs of Kombu. Kombu with py-amqp has very little overhead compared to kombu with "virtual transports", and it implements many patterns required for most applications of AMQP, like connection pools, failover, serialization, etc.

[ask]

The comment on the name is a good point, and we could probably rename the repository. The reason I named it py-amqp in the first place is I was thinking we may have clients written in languages other than Python some day.

[edmorley]

@edmorley RTD latest is now changed to use the 2.0 branch,
and the README was rendered from source to fix the wrong version.

Many thanks :-)

[eliasdorneles]

Hello!

The ReadTheDocs setup seems to continue being a problem -- here is an image illustrating my confusion trying to figure out the latest stable version:

(I wanted to find the changelog, i ended up finding it on Github: https://github.com/celery/py-amqp/blob/master/Changelog)