Maintainability Rules
=====================

.. toctree::
   :maxdepth: 1
   :hidden:

   hardcoded_env_values
   missing_workflow_description
   no_reusable_workflow
   workflow_too_complex

.. list-table::
   :header-rows: 1
   :widths: 30 15 55

   * - Rule
     - Severity
     - Description
   * - :doc:`hardcoded_env_values`
     - medium
     - Values like URLs, bucket names, or region names are hardcoded in the workflow instead of being referenced from repositor...
   * - :doc:`no_reusable_workflow`
     - medium
     - Identical job definitions appear across multiple workflow files without using reusable workflows (workflow_call trigger)...
   * - :doc:`workflow_too_complex`
     - low
     - Workflow has more than 20 steps across jobs without using reusable workflows or composite actions to reduce complexity.
   * - :doc:`missing_workflow_description`
     - info
     - Jobs or steps are missing a name field, making CI logs harder to read and debug.