Update hf_api.py (huggingface#3194)

* Update hf_api.py

Add short example detailing how to obtain a DatasetInfo object for a given dataset.

* Update src/huggingface_hub/hf_api.py

* add similar docs for spaces and models

* format

* format

* Apply style fixes

---------

Co-authored-by: github-actions[bot] <github-actions[bot]@users.noreply.github.com>

Author: 2 people

src/huggingface_hub/hf_api.py

@@ -739,7 +739,7 @@ def __init__(self, **kwargs):
 @dataclass
 class ModelInfo:
     """
-    Contains information about a model on the Hub.
+    Contains information about a model on the Hub. This object is returned by [`model_info`] and [`list_models`].
 
     <Tip>
 
@@ -938,7 +938,7 @@ def __init__(self, **kwargs):
 @dataclass
 class DatasetInfo:
     """
-    Contains information about a dataset on the Hub.
+    Contains information about a dataset on the Hub. This object is returned by [`dataset_info`] and [`list_datasets`].
 
     <Tip>
 
@@ -1057,7 +1057,7 @@ def __init__(self, **kwargs):
 @dataclass
 class SpaceInfo:
     """
-    Contains information about a Space on the Hub.
+    Contains information about a Space on the Hub. This object is returned by [`space_info`] and [`list_spaces`].
 
     <Tip>