docs: improve the check descriptions automatically shown in terminal (#1190)

Signed-off-by: behnazh-w <[email protected]>

Author: behnazh-w

src/macaron/slsa_analyzer/checks/build_as_code_check.py

@@ -86,7 +86,7 @@ class BuildAsCodeCheck(BaseCheck):
     def __init__(self) -> None:
         """Initiate the BuildAsCodeCheck instance."""
         description = (
-            "The build definition and configuration executed by the build "
+            "Check if the build definition and configuration executed by the build "
             "service is verifiably derived from text file definitions "
             "stored in a version control system."
         )

src/macaron/slsa_analyzer/checks/detect_malicious_metadata_check.py

@@ -77,12 +77,12 @@ class MaliciousMetadataFacts(CheckFacts):
 
 
 class DetectMaliciousMetadataCheck(BaseCheck):
-    """This check analyzes the metadata of a package for malicious behavior."""
+    """This check analyzes a package for malicious behavior."""
 
     def __init__(self) -> None:
         """Initialize a check instance."""
         check_id = "mcn_detect_malicious_metadata_1"
-        description = """This check analyzes the metadata of a package based on reports malicious behavior.
+        description = """Check if the package is malicious.
         """
         super().__init__(check_id=check_id, description=description, eval_reqs=[])