adding guide

done for [AGIOS-313](https://issues.jboss.org/browse/AGIOS-313)

@corinnekrych mind to review?
> decided to leave it for next release until we comprehend it better.

perfect!