extended documentation with some examples
warningTerms are no longer passed as they are already in the context
added standard conform comments