T ispn 3681/update docs

https://issues.jboss.org/browse/ISPN-3682