Django-setup-configuration

==================

**Maintenance**

* [open-zaak/open-zaak1856] Allow Django 5 as a dependency.

==================

**Bugfixes**

* [62] Fix ``setup-config-usage`` ToS step links

==================

**New features**

* Add a directive for general purpose documentation in downstream projects

**Bugfixes and QoL Changes**
* Do not mark blank=True strings as polymorphic
* [58] Add example for UUID field in directive
* Provide more descriptive errors on step loading in runner

==================

**New features**

* Add a ``validate-only`` flag to support web-init/CI usage
* [45] Sphinx directive to generate YAML examples for config models

**Bugfixes and QoL changes**

* [31] Bypass validation of defaults for Django fields containing choices
* [39] Make command output clearer and less opaque
* [29] Accept Path objects for YAML files
* [42] Handle Site creation in SitesConfigurationStep when no Sites models
* [37] Explicitly handle transactions in the runner

**Documentation**

* [49] Add documentation for ``setup_configuration`` command usage

==================

* Fixed an issue (27) whereby empty strings would not be part of the string literal
inferred from a string-based field's ``options`` when using a Django field ref.
* Added a generic configuration step for the Django sites module.
* Slug fields are now explicitly validated in Django field refs.

==================

💥 **NOTE**: This release contains a number of significantly breaking changes. 💥

* The core API of the configuration steps has been changed to rely on Pydantic-based
configuration models, and to rely solely on an ``execute`` hook, with ``is_configured``
and ``test_results`` being deprecated. Details of the new API can be found in the
README.
* The ``generate_config_docs`` command has been disabled until it can amended to work
with the new API, which is planned for an upcoming release.