refactor: rename coverage.php to more explaining name and add comment…

… what it does

.github/workflows/coverage-diff.yml

@@ -32,7 +32,7 @@ jobs:
       - name: Create coverage report for PR
         id: pr_coverage
         run: |
-          php ./coverage.php
+          php ./generate_coverage_report.php
           COVERAGE_PR=$(jq -r '.total.statements.pct' cov/json/index.json)
           echo "COVERAGE_PR=$COVERAGE_PR" >> $GITHUB_ENV
       - name: Upload coverage report markdown
@@ -67,8 +67,8 @@ jobs:
         run: |
           COVERAGE_BASE=0
           
-          if [ -f "./coverage.php" ]; then
-            php ./coverage.php
+          if [ -f "./generate_coverage_report.php" ]; then
+            php ./generate_coverage_report.php
           fi
           
           if [ -f "cov/json/index.json" ]; then

.github/workflows/coverage-report.yml

@@ -29,7 +29,7 @@ jobs:
       - name: PHPUnit
         run: docker-compose run --user "$(id -u):$(id -g)" phpunit
       - name: "Parse Coverage"
-        run: "php ./coverage.php"
+        run: "php ./generate_coverage_report.php"
       - name: Create Coverage Badges
         uses: jaywcjlove/coverage-badges-cli@df58615045079f1c827de7867044bbab3ec22b43
         with:

contributing.md

@@ -29,9 +29,9 @@ To generate a code coverage report, follow these steps:
    - The Clover XML report will be saved in `cov/xml/clover.xml`.
    - The HTML report will be saved in the `cov/html` directory.
 
-2. To convert the Clover XML report into a markdown report, run the coverage.php script:
+2. To convert the Clover XML report into a markdown report, run the generate_coverage_report.php script:
    ```shell
-   docker-compose run php php coverage.php
+   docker-compose run php php generate_coverage_report.php
    ```
 
 The markdown report will be saved in the `cov/markdown/coverage_report.md` file. You can open this file to review the coverage details.

coverage.php → generate_coverage_report.php

@@ -1,5 +1,7 @@
 <?php
 
+# This script generates JSON report for coverage badge github action and generates markdown report for coverage-diff github action
+
 $outputPath = __DIR__ . "/cov/json/";
 $markdownPath = __DIR__ . "/cov/markdown/";