IssueTracker

Artifact used (ex. androidx.appcompat:appcompat:1.0.0-alpha1): androidx.slice:slice-builders and androidx.slice:slice-core
Version used: 1.0.0 (also affects 1.1.0-alpha01)

Steps to Reproduce the Problem:

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

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

Step #3: 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 #4: Notice that the JavaDocs do point out an implementation of SliceAction... which is also named SliceAction

Step #5: 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).

This was originally filed against the 1.0.0 beta as https://issuetracker.google.com/issues/111716610.