IssueTracker

The support libraries and a few third party libraries provide compatibility methods for operation on older APIs where shims or backport implementations must be used. The problem is that there's no way to inform the user of when they no longer need to be using these methods.

I propose adding a new annotation to support-annotations like @DeprecatedSdkVersion whose value property is an SDK_INT but also provides an optional details property for what method to use instead.

    public @Interface DeprecatedSdkVersion {
      int value();
      String details = "";
    }

Which can be used like this:

    public final class ViewCompat {
      @DeprecatedSdkVersion(Build.VERSION_CODES.LOLLIPOP)
      public static int getElevation(View view) { ... }

      @DeprecatedSdkVersion(
          value = Build.VERSION_CODES.LOLLIPOP,
          details = "Use view.getElevation() directly."
      )
      public static int getElevation(View view) { ... }
    }

(Other potential names: @MaxSdkVersion, @UntilSdkVersion)

This would come with a corresponding lint check that would issue a warning if you were using one of these methods with a minSdkVersion higher than the annotation's value.