.coderabbit.yaml

reviews:
  path_instructions:
    - path: "website/docs/commands/*.mdx"
      instructions: |
        These command reference files are generated by `build/Update-CommandReference.ps1`.
        The generator sets `custom_edit_url` from a flattened `powershell/public/` base, so the URL does not always mirror the source file's nested folder on disk.
        Do not flag `custom_edit_url` as incorrect solely because the corresponding PowerShell source file lives in a subdirectory such as `powershell/public/core`, `powershell/public/cis`, `powershell/public/maester`, or similar.
        Only raise an issue if the link is malformed, points outside this repository, or contradicts the generator logic.
    - path: "website/versioned_docs/**/commands/*.mdx"
      instructions: |
        These versioned command docs are generated artifacts copied from `website/docs/commands`.
        Apply the same rule for `custom_edit_url`: flattened `powershell/public/...` links are expected and should not be flagged as wrong just because the backing source file is stored in a nested folder.