MOD: adding convenience methods, updating docs