documenting + and making unit tests match examples in the docs