new functions and docs.md test