[doc] add honest analyse of the disadvantages of this solution in the README
[enh] add README.md in setup.py long_description
[doc] fix example for include