added a few utility methods + documentation