DOC: clean up typos, formatting; add reference
BF: fix isinstance check to use ndarray

The isinstance check was using np.array as the array class, but the
class is np.ndarray
Merge pull request #4 from matthew-brett/workon-slice-times

DOC: clean up typos, formatting; add reference