[Issue #186] finished implementation, docs