adding guide

done for [AGIOS-313](https://issues.jboss.org/browse/AGIOS-313)

@corinnekrych mind to review?
Any comments about async ?