---
upgrade:
  - |
    The default value of ``[oslo_policy] policy_file`` config option has been
    changed from ``policy.json``
    to ``policy.yaml``. Nova policy new defaults since 21.0.0 and current
    default value of ``[oslo_policy] policy_file`` config option (``policy.json``)
    does not work when ``policy.json`` is generated by
    `oslopolicy-sample-generator <https://docs.openstack.org/oslo.policy/latest/cli/oslopolicy-sample-generator.html>`_  tool.
    Refer to `bug 1875418 <https://bugs.launchpad.net/nova/+bug/1875418>`_
    for more details.
    Also check `oslopolicy-convert-json-to-yaml <https://docs.openstack.org/oslo.policy/latest/cli/oslopolicy-convert-json-to-yaml.html>`_
    tool to convert the JSON to YAML formatted policy file in
    backward compatible way.
fixes:
  - |
    Bug `1875418 <https://bugs.launchpad.net/nova/+bug/1875418>`_ is fixed
    by changing the default value of ``[oslo_policy] policy_file`` config
    option to YAML format.
