[DOC] Enhance BestEstimator docstrings

[SimonBlanke]

File: src/hyperactive/integrations/sklearn/best_estimator.py

Description: The BestEstimator class has minimal one-word docstrings. This should be improved.

Methods to document:

• score_samples()
• predict()
• predict_proba()
• decision_function()
• transform()
• inverse_transform()
• classes_

What to do:

• Add parameter descriptions (X: array-like)
• Add return type documentation
• Add better description

[Eshaan-byte]

Hi @SimonBlanke can I work on this issue? Thank you!

[omkar-334]

hey @SimonBlanke can i work on this? Is it enough if these docstrings are taken from the scikit-learn implementation? https://github.com/scikit-learn/scikit-learn/blob/main/sklearn/model_selection/_search.py