Artifact used (ex. androidx.appcompat:appcompat:1.0.0-alpha1): androidx.slice:slice-builders:1.0.0-beta01
Version used: 1.0.0-beta01

Steps to Reproduce the Problem:

Step #1: Open up a project that had been using the alpha libraries, and update them to beta01

Step #2: Notice that SliceAction constructors are marked as library-only

Step #3: Search the documentation for SliceAction, to determine how we are supposed to create instances of this class

Step #4: Land on https://developer.android.com/reference/androidx/slice/core/SliceAction.html

Step #5: Notice that this is an interface, with no details in the JavaDocs about where and how you are supposed to get instances of this interface

Step #6: Notice that the JavaDocs do point out an implementation of SliceAction... which is also named SliceAction

Step #7: Visit that class documentation at https://developer.android.com/reference/androidx/slice/builders/SliceAction and see factory methods that can be used

At minimum, please consider putting documentation on the interface SliceAction to explain that the concrete implementation is the other SliceAction. Even better, rename one of these to be something other than SliceAction, so developers do not get mystified (e.g., code completion).

Thanks for considering this!

Issue 111716610

Links (2)

Issue metadata