Ensure all configuration options are clearly documented and follow consistent naming and syntax conventions. This includes:

  1. Explicitly document prerequisites - Clearly state all required tools, dependencies, and environment variables needed for configuration. For example, when jq is required for processing:
    terraform show -json tfplan.binary | jq > tfplan.json
    
  2. Use proper syntax for configuration files - When defining multiple options with the same key in JSON configurations, use arrays:
    "//": [
      "checkov:skip=CVE-2023-123: ignore this CVE for this file",
      "checkov:skip=express[BC_LIC_2]: ignore license violations"
    ]
    
  3. Follow consistent naming conventions - For configuration flags and environment variables:
  4. Place configurations in appropriate locations - Environment variables should be documented in Settings blocks, and related configuration options should be grouped together.