DOC/API: doc-strings for instrospectors
xref #13147

ideally add doc-strings and add to API.rst? for the introspectors
these are pretty intuitve (e.g. `is_integer`), but have some nuances that
doc-strings (and an example) would be useful.
