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?
I just noticed in the docs that the page for
numpy.random.sampleindicates that the function should be called asnumpy.random.random_sample. I understand that this may just indicate that the function may be called as eithersampleorrandom_sample, but it does come across as a mistake when first viewing the page. Perhaps make it more explicit thatrandom_sampleis an alias ofsample? Or is this the accepted practice for functions that have aliases?