Recently I wanted to remove a deprecation warning generated by Gradle 1.6+ on my plugin and I had to use git blame to get know that a TaskContainer.create(String name, Class type) method was added in Gradle 1.6. I could accidentally make a unpleasant surprise for people using Gradle <=1.5 (just a few days after 1.6 was released). It would be useful in a case of the methods designed as a replacement for deprecated ones to have a @since tag in JavaDoc to easier decide when to drop a support for earlier Gradle versions.