diff --git a/docs/html/training/tv/discovery/recommendations.jd b/docs/html/training/tv/discovery/recommendations.jd index ffe33f28bb000..0b0b270448175 100644 --- a/docs/html/training/tv/discovery/recommendations.jd +++ b/docs/html/training/tv/discovery/recommendations.jd @@ -63,10 +63,13 @@ recommendations you should consider:
For more information on how to design recommendation cards for the best user experience, see @@ -88,6 +91,25 @@ To learn more, see Recommendation Row in the Android TV Design Spec.
++You can optionally group recommendations based on recommendation source. For example, your app +might provide two groups of recommendations: recommendations for content the user is subscribed to, +and recommendations for new trending content the user might not be aware of. +
++The system ranks and orders recommendations for each group separately when creating or updating +the recommendation row. By providing group information for your recommendations, you can ensure +that your recommendations don’t get ordered below unrelated recommendations. +
+
+Use
+{@link android.support.v4.app.NotificationCompat.Builder#setGroup
+NotificationCompat.Builder.setGroup()} to set the group key string of a recommendation. For
+example, to mark a recommendation as belonging to a group that contains new trending content,
+you might call setGroup("trending").
+