I get the point and yes, that is true, but we need also, maybe a different way, then to make it more user friendly.
If I look with the eyes of a person who is looking for a certain add on for my plone site, currently we are not 'user friendly' at all.
This is IMHO bad, there is a difference between developer/provider and a user who wants to install an add on.
As a user, I do not want to scroll down on pypi to find out which version is supported.
Personally I think a README is even not user friendly enough at all, but to be fair I opened this post with the question for an Integrator
Yes, you are right that ppl may forget to update the README, this is the same problem that we have with /docs. But I also see ppl forgetting to upgrade their setup.py sometimes.
To solve this at least partly, we could write a test, that compares the version in setup.py with your versions in the README.
Yes, you can do ttd with documentation, just saying :