Definitions aren't proper resources this should work as an LWRP tho.
Perhaps it's time to deprecate definitions and start deorbiting them in time for Chef 12?
Those of us who have been using Chef for a while and following the list know that they are the poor step-brothers of LWRPs, but new users are still confused and start using them, only to be told to stop.
Is there any strong argument to keeping them? I'm not aware of any good reason.
My proposal is to to:
* remove them from the documentation, or at least clearly mark them as "do not use in new code";