Issue #2216539 by jhodgdon: Fill in @defgroup/topic docs for Views overview.

core/modules/views/src/Plugin/views/argument_default/ArgumentDefaultPluginBase.php

@@ -17,8 +17,8 @@
  * @{
  * Plugins for argument defaults in Views.
  *
- * Argument default plugins provide default values for contextual filters.
- * This is useful for blocks and other display types lacking a natural argument
+ * Argument default plugins provide default values for contextual filters. This
+ * can be useful for blocks and other display types lacking a natural argument
  * input. Examples are plugins to extract node and user IDs from the URL.
  *
  * Argument default plugins extend

core/modules/views/src/Plugin/views/argument_validator/ArgumentValidatorPluginBase.php

@@ -17,7 +17,7 @@
  * @{
  * Plugins for validating views contextual filters.
  *
- * Views argument validator plugins validate contextual filters (arguments) on
+ * Views argument validator plugins validate arguments (contextual filters) on
  * views. They can ensure arguments are valid, and even do transformations on
  * the arguments. They can also provide replacement patterns for the view title.
  * For example, the 'content' validator verifies verifies that the argument

core/modules/views/src/Plugin/views/cache/CachePluginBase.php

@@ -14,10 +14,9 @@
 /**
  * @defgroup views_cache_plugins Views cache plugins
  * @{
- * Plugins to handle the storage and loading of Views caches.
+ * Plugins to handle Views caches.
  *
- * Cache plugins control the storage and loading of caches in Views, for
- * both result and render caching.
+ * Cache plugins control how caching is done in Views.
  *
  * Cache plugins extend \Drupal\views\Plugin\views\cache\CachePluginBase.
  * They must be annotated with \Drupal\views\Annotation\ViewsCache

core/modules/views/src/Plugin/views/field/FieldPluginBase.php

@@ -33,8 +33,11 @@
  * The following items can go into a hook_views_data() implementation in a
  * field section to affect how the field handler will behave:
  * - additional fields: An array of fields that should be added to the query.
- *   The array is in the form of:
+ *   The array is in one of these forms:
  *   @code
+ *   // Simple form, for fields within the same table.
+ *   array('identifier' => fieldname)
+ *   // Form for fields in a different table.
  *   array('identifier' => array('table' => tablename, 'field' => fieldname))
  *   @endcode
  *   As many fields as are necessary may be in this array.

core/modules/views/src/Plugin/views/style/StylePluginBase.php

@@ -18,7 +18,7 @@
  * @{
  * Plugins that control how the collection of results is rendered in a view.
  *
- * Style plugins control a view is displayed. For the most part, they are
+ * Style plugins control how a view is displayed. For the most part, they are
  * object wrappers around theme templates. Examples of styles include HTML
  * lists, tables, full or teaser content views, etc.
  *