Users will not see the deprecations marked here and they may not follow the documenation changes. In #180 I added a JobManagement.logDeprecationWarning method to write deprecation warnings to the build log. So it's more likely that a user will notice that something is going to change. I'm not sure if I want to merge #180, but I could extract the deprecation warning code to a new PR which could then be integrated here. What do you think?