fix(docs): Minor changes (#832)

Fix #831

skore/src/skore/item/cross_validation_item.py

@@ -252,8 +252,9 @@ class CrossValidationItem(Item):
     """
     A class to represent the output of a cross-validation workflow.
 
-    This class encapsulates the output of scikit-learn's cross-validate function along
-    with its creation and update timestamps.
+    This class encapsulates the output of the
+    :func:`sklearn.model_selection.cross_validate` function along with its creation and
+    update timestamps.
     """
 
     def __init__(
@@ -272,14 +273,16 @@ def __init__(
         Parameters
         ----------
         cv_results_serialized : dict
-            The dict output of scikit-learn's cross_validate function,
-            in a form suitable for serialization.
+            The dict output of the :func:`sklearn.model_selection.cross_validate`
+            function, in a form suitable for serialization.
         estimator_info : dict
             The estimator that was cross-validated.
         X_info : dict
-            A summary of the data, input of scikit-learn's cross_validation function.
+            A summary of the data, input of the
+            :func:`sklearn.model_selection.cross_validate` function.
         y_info : dict
-            A summary of the target, input of scikit-learn's cross_validation function.
+            A summary of the target, input of the
+            :func:`sklearn.model_selection.cross_validate` function.
         plot_bytes : bytes
             A plot of the cross-validation results, in the form of bytes.
         created_at : str
@@ -313,9 +316,11 @@ def factory(
         estimator : sklearn.base.BaseEstimator,
             The estimator that was cross-validated.
         X
-            The data, input of scikit-learn's cross_validation function.
+            The data, input of the :func:`sklearn.model_selection.cross_validate`
+            function.
         y
-            The target, input of scikit-learn's cross_validation function.
+            The target, input of the :func:`sklearn.model_selection.cross_validate`
+            function.
 
         Returns
         -------

skore/src/skore/project/create.py

@@ -70,7 +70,7 @@ def create(
         Name of the project to be created, or a relative or absolute path.
     working_dir : Path or None
         If ``project_name`` is not an absolute path, it will be considered relative to
-        ``working_dir``. If `project_name` is an absolute path, ``working_dir`` will
+        ``working_dir``. If ``project_name`` is an absolute path, ``working_dir`` will
         have no effect. If set to ``None`` (the default), ``working_dir`` will be re-set
         to the current working directory.
     overwrite : bool

skore/src/skore/project/project.py

@@ -166,7 +166,7 @@ def get_item(self, key: str) -> Item:
         Returns
         -------
         item : Item
-            The Item corresponding to key ``key``.
+            The Item corresponding to ``key``.
 
         Raises
         ------
@@ -179,7 +179,7 @@ def get_item_versions(self, key: str) -> list[Item]:
         """
         Get all the versions of an item associated with ``key`` from the Project.
 
-        The list is ordered from oldest to newest "put" date.
+        The list is ordered from oldest to newest :func:`~skore.Project.put` date.
 
         Parameters
         ----------
@@ -189,7 +189,7 @@ def get_item_versions(self, key: str) -> list[Item]:
         Returns
         -------
         list[Item]
-            The list of items corresponding to key ``key``.
+            The list of items corresponding to ``key``.
 
         Raises
         ------

skore/src/skore/sklearn/cross_validate.py

@@ -17,7 +17,7 @@
 
 
 def _get_scorers_to_add(estimator, y) -> list[str]:
-    """Get a list of scorers based on `estimator` and `y`.
+    """Get a list of scorers based on ``estimator`` and ``y``.
 
     Parameters
     ----------

sphinx/api.rst

@@ -5,6 +5,10 @@ API
 
 This page lists all the public functions and classes of the skore package.
 
+.. warning ::
+
+    This code is still in development. **The API is subject to change.**
+
 Project
 -------
 

sphinx/conf.py

@@ -105,7 +105,7 @@
             "icon": "fa-brands fa-discord",
         },
     ],
-    "announcement": "This code is still in development. <strong>The API is subject to change.</strong>",
+    # "announcement": "This code is still in development. <strong>The API is subject to change.</strong>",
 }
 
 # Plausible Analytics