docs: Add documentation for Configurable Warnings

This includes detailing the use of `fatal-warnings` within project.conf

This also adds a deprecation notice to the fail on overlaps section.