Add missing docblocks to \Drupal\views\Plugin\views\display\DisplayPluginInterface

Thanks for filing this issue and making a patch! It's almost perfect; just needs a small amount of work:

1. +++ b/core/modules/views/src/Plugin/views/display/DisplayPluginInterface.php
   @@ -37,8 +37,22 @@
   +   * Initialize the display plugin.
   

   Initialize => Initializes

2. +++ b/core/modules/views/src/Plugin/views/display/DisplayPluginInterface.php
   @@ -37,8 +37,22 @@
   +   *   * @return mixed
   +   */
      public function initDisplay(ViewExecutable $view, array &$display, array &$options = NULL);
   

   This looks like a typo.

   @return should not be indented like this, and there is an additional * on the line.

   Also there should be a blank line between the @param section and the @return

   And the return value needs to be documented. What is returned from this method?

I removed @return because &$display is passed as reference, and all initDisplay() methods don't return anything.

Agreed, that method does not return anything. And given that, removing the @return is correct.

The new patch looks great! Thanks!

+++ b/core/modules/views/src/Plugin/views/display/DisplayPluginInterface.php
@@ -37,8 +37,21 @@
+   * @param array $options
+   *   The options for the display plugin.

The param description should be preceded with (optional) and prefixed with Defaults to NULL..

As this is a documentation change it is rc eligilbe

+1 for RTBC

Updated based on feedback in #7

Thanks!

Interdiff files are always appreciated, for the next time...

Committed 0a9d46f and pushed to 8.0.x. Thanks!