Documented expected value and side effect
Merge pull request #45 from buzzfeed/1121-AK-61231320-documentation-rc2

Documented expected value and side effect