On 17/01/2013, at 12:43 AM, Luke Daley wrote: > > On 16/01/2013, at 1:25 PM, Hans Dockter <[email protected]> wrote: > >> >> >> On Wed, Jan 16, 2013 at 2:08 PM, Luke Daley <[email protected]> >> wrote: >> There was talk around the 1.2 era where we were talking about improving the >> user experience when dealing with deprecations. I think we should bump up >> the priority of this and address it in the next release or two. >> >> I just updated an old project to 1.3 and received: “The >> Project.dependsOnChildren() method has been deprecated and is scheduled to >> be removed in Gradle 2.0.” >> >> As a user, that's far from helpful. What should I do now? How do I know what >> the replacement is? We've already identified things that we could do to >> improve this. >> >> My perception may be off on this in terms of high it is prioritised, but I >> feel that it should be higher. It's an easy thing to “forget” about. >> >> This is something we should tackle. We could provide an URL where a user can >> learn what are the alternatives. >> >> Anything else you have in mind to improve this? > > Something like: > > 1. Create a deprecation database in the userguide, where each deprecation is > assigned an id and a reasonable explanation is given > 2. Each deprecation can be linked to > 3. Deprecation messages include this link
I quite like this plan. There's also the 'blame' piece, to let the user know where the deprecated feature is being used. > > Optional… > > 4. Users can acknowledge deprecations (by id) somehow and suppress the output > 5. The deprecations section of the release notes is automated, based on the > deprecations database > 6. Profile report includes information about triggered deprecations > 7. Build comparison report includes information about triggered deprecations > > -- > Luke Daley > Principal Engineer, Gradleware > http://gradleware.com > > > --------------------------------------------------------------------- > To unsubscribe from this list, please visit: > > http://xircles.codehaus.org/manage_email > > -- Adam Murdoch Gradle Co-founder http://www.gradle.org VP of Engineering, Gradleware Inc. - Gradle Training, Support, Consulting http://www.gradleware.com
