I just noticed in the docs that the page for numpy.random.sample indicates that the function should be called as numpy.random.random_sample. I understand that this may just indicate that the function may be called as either sample or random_sample, but it does come across as a mistake when first viewing the page. Perhaps make it more explicit that random_sample is an alias of sample? Or is this the accepted practice for functions that have aliases?