Apparently chef 16 introduced a new "unified mode" for custom resources, chef 17 is actively suggesting to enable it and chef 18 will enable it by default.
As a result cookstyle has now (quite reasonably) started to suggest enabling it.
My problem is that I can't find out what it actually does, beyond a one line summary in various release announcements, and as far as I can tell it is never mentioned anywhere in the documentation.
So what are the consequences of enabling it? Presumably there is some risk that existing custom resources will need changes when using it or it would just have been turned on by default.
So what do I need to look out for when considering enabling it for a resource?