corrected docs and tests