redefined docs with full coverage