fixes to docs and tests