diff --git a/src/Datasource/DatasourceInterface.php b/src/Datasource/DatasourceInterface.php
index edf02020..5148f24a 100644
--- a/src/Datasource/DatasourceInterface.php
+++ b/src/Datasource/DatasourceInterface.php
@@ -239,11 +239,15 @@ interface DatasourceInterface extends IndexPluginInterface {
   public function getFieldDependencies(array $fields);
 
   /**
-   * The list cache contexts associated with this datasource.
-   *
-   * Allows lists that contain items from this data source to be varied as
-   * necessary, typically to ensure users of role A see other items listed than
-   * users of role B.
+   * Returns the list cache contexts associated with this datasource.
+   *
+   * List cache contexts ensure that if items from a datasource are included in
+   * a list that any caches containing this list are varied as necessary. For
+   * example a View might contain a number of items from this data source that
+   * are visible only by users that have a certain role. These list cache
+   * contexts will ensure that separate cached versions exists for users with
+   * this role and without it. They should be included whenever a list is
+   * rendered that contains items from this datasource.
    *
    * @return string[]
    */