adding expects method and tests
adding documentation