Document the warnings functionality
Document the warnings functionality

This documentation is a bit verbose, as I tried to cover the
substitution behaviour, which is not covered elsewhere in the
documentation.

alphagov/publishing-api,alphagov/publishing-api