On a philosophical point, checking the type of an object doesn't feel like good Ruby style, and as such I don't think we should be leading with it in our documentation. Why not use the same example you used in the text above (contains this key but not that key)?