doc: reference upcoming API
docs: update coreos banner
doc: update security
docs: update README and links
Merge pull request #819 from jonboulle/master

docs: several more changes