diff -u b/core/modules/views/views.api.php b/core/modules/views/views.api.php
--- b/core/modules/views/views.api.php
+++ b/core/modules/views/views.api.php
@@ -588,6 +588,9 @@
  * The field module's implementation of hook_views_data_alter() invokes this for
  * each field storage, in the module that defines the field type. It is not
  * invoked in other modules.
+ * 
+ * Views implmentation of hook_views_data_alter() invokes this on the module 
+ * that provides the field storage definition.
  *
  * Unlike hook_field_views_data_alter(), this operates on the whole of the views
  * data. This allows a field type to add data that concerns its fields in