Describe the issue linked to the documentation

Fix some docstring inconsistencies in

Suggest a potential alternative/fix

Example: Use array-like of shape (my_shape_size), see https://scikit-learn.org/stable/developers/contributing.html#guidelines-for-writing-documentation.