Merge pull request #817 from jonboulle/master

doc: move examples into new folder, update service discovery
Merge pull request #818 from jonboulle/master

docs: collapse deployment and configuration
doc: reference upcoming API