MAINT: using np.random.shuffle, thanks @gregcaporaso\!
DOC: addressing @gregcaporaso's doc comments