update docs to include tests