updated api docs
cleanup
implementation drill-down