docs(expect): document methods and add examples

docs(expect): document methods and add examples #657