Policy file documentation is incomplete

[andy-maier]

Checklist

• I agree to the terms within the Safety Code of Conduct.
• I have searched existing issues to ensure this bug hasn't been reported before.

Safety version

The documentation of the version 3.0 policy files at https://docs.safetycli.com/safety-docs/administration/safety-policy-files is incomplete:

• It misses report:dependency-vulnerabilities:auto-ignore-in-report:vulnerabilities, e.g.

  report:
    . . .
    dependency-vulnerabilities:
      . . .
      auto-ignore-in-report:
        . . .
        vulnerabilities:
          51457:
            reason: Py package is no longer being fixed (latest version 1.11.0)
            expires: '2099-01-01'
  

• It misses installation, e.g.

  installation:
    default-action: allow
    audit-logging:
      enabled: true
    allow:
      packages: []
      vulnerabilities: {}
    deny:
      packages: {}
      vulnerabilities:
        warning-on-any-of:
          cvss-severity: []
          block-on-any-of:
          cvss-severity: []
  

Python version

3.12

Operating System

macOS 15

Bug description

Documentation bug - see above

Steps to reproduce

Read https://docs.safetycli.com/safety-docs/administration/safety-policy-files

Command and output

N/A

Additional context

N/A

[github-actions]

Hi @andy-maier, thank you for opening this issue!

We appreciate your effort in reporting this. Our team will review it and get back to you soon.
If you have any additional details or updates, feel free to add them to this issue.

Note: If this is a serious security issue that could impact the security of Safety CLI users, please email security@safetycli.com immediately.

Thank you for contributing to Safety CLI!