improved docs & resolved #
14