better doc on external API & fixes

info on the external API activation
links to the libs
better usage of Markdown syntax