docblock updates:
note the abstract is a decorator