DOC: add documentation for some scalar checks

DOC: Mention that PyArray_Return steals a reference to arr