adding guide

done for [AGIOS-313](https://issues.jboss.org/browse/AGIOS-313)

@corinnekrych mind to review?
Can I use this in combination with the HTTP lib?