Apply suggestions from code review

Co-authored-by: Daniel Rüdt <117752024+daniel-rdt@users.noreply.github.com>

Author: tgilon

doc/release_notes.md

@@ -80,7 +80,7 @@
 
 * Use `combine_indicators` instead of `collect_indicators` in the function `summary_benchmark_indicators` ([#797](https://github.com/open-energy-transition/open-tyndp/pull/797)).
 
-* Refactor `clean_projects` script to reduce the redundancy in its outputs ([#804](https://github.com/open-energy-transition/open-tyndp/issues/804)).
+* Refactor `clean_projects` script to reduce the redundancy in its outputs ([#807](https://github.com/open-energy-transition/open-tyndp/issues/807)).
 
 
 ## Upcoming PyPSA-Eur Release

scripts/cba/clean_projects.py

@@ -419,7 +419,7 @@ def build_method_assignments(
     Returns
     -------
     pd.DataFrame
-        List of the method to apply on projects.
+        DataFrame of projects with the corresponding method to apply.
     """
     guidelines = guidelines.rename(
         columns={

scripts/cba/prepare_project.py

@@ -22,9 +22,12 @@
 
 def check_method(method: str) -> str:
     """
-    Normalize and validate the CBA method name.
+    Normalize and validate a given CBA method name.
 
-    If the method is not recognized as either "pint" or "toot", a ValueError is raised.
+    Raises
+    ------
+    ValueError
+        If the normalized value is neither "pint" nor "toot".
     """
     method = method.lower().strip()
     if method not in ["pint", "toot"]: