DOC: Fix formatting for Raises section
DOC: Add simple examples, link function names, mention that input arrays are converted to float (no integer or complex or object)