finalized feature implementation for version 1.0 - tests/docs/xxx to come