Issue #3268829 by quietone, bbrala: Fix class property comments for Drupal.Commenting.DocComment.ShortSingleLine

core/lib/Drupal/Component/Utility/Unicode.php

@@ -77,8 +77,7 @@ EOD;
   const STATUS_SINGLEBYTE = 0;
 
   /**
-   * Indicates that full unicode support with the PHP mbstring extension is
+   * Indicates that full unicode support with PHP mbstring extension is used.
-   * being used.
    */
   const STATUS_MULTIBYTE = 1;
 

core/lib/Drupal/Core/Ajax/OpenDialogCommand.php

@@ -37,16 +37,18 @@ class OpenDialogCommand implements CommandInterface, CommandWithAttachedAssetsIn
   protected $content;
 
   /**
-   * Stores dialog-specific options passed directly to jQuery UI dialogs. Any
+   * Stores dialog-specific options passed directly to jQuery UI dialogs.
-   * jQuery UI option can be used. See http://api.jqueryui.com/dialog.
+   *
+   * Any jQuery UI option can be used.
+   *
+   * @see http://api.jqueryui.com/dialog.
    *
    * @var array
    */
   protected $dialogOptions;
 
   /**
-   * Custom settings that will be passed to the Drupal behaviors on the content
+   * Custom settings passed to Drupal behaviors on the content of the dialog.
-   * of the dialog.
    *
    * @var array
    */

core/lib/Drupal/Core/Annotation/QueueWorker.php

@@ -52,15 +52,14 @@ class QueueWorker extends Plugin {
   public $title;
 
   /**
-   * An associative array containing an optional key.
+   * An optional associative array of settings for cron.
-   *
-   * This property is optional and it does not need to be declared.
-   *
-   * Available keys:
-   * - time (optional): How much time Drupal cron should spend on calling this
-   *   worker in seconds. Defaults to 15.
    *
    * @var array
+   *   The array has one key, time, which is set to the time Drupal cron should
+   *   spend on calling this worker in seconds. The default is set in
+   *   \Drupal\Core\Queue\QueueWorkerManager::processDefinition().
+   *
+   * @see \Drupal\Core\Queue\QueueWorkerManager::processDefinition()
    */
   public $cron;
 

core/lib/Drupal/Core/Database/Database.php

@@ -58,8 +58,7 @@ abstract class Database {
   const RETURN_INSERT_ID = 3;
 
   /**
-   * A nested array of all active connections. It is keyed by database name
+   * A nested array of active connections, keyed by database name and target.
-   * and target.
    *
    * @var array
    */

core/lib/Drupal/Core/Database/Query/Select.php

@@ -93,8 +93,9 @@ class Select extends Query implements SelectInterface {
   protected $range;
 
   /**
-   * An array whose elements specify a query to UNION, and the UNION type. The
+   * An array whose elements specify a query to UNION, and the UNION type.
-   * 'type' key may be '', 'ALL', or 'DISTINCT' to represent a 'UNION',
+   *
+   * The 'type' key may be '', 'ALL', or 'DISTINCT' to represent a 'UNION',
    * 'UNION ALL', or 'UNION DISTINCT' statement, respectively.
    *
    * All entries in this array will be applied from front to back, with the

core/lib/Drupal/Core/Entity/Annotation/EntityReferenceSelection.php

@@ -60,8 +60,9 @@ class EntityReferenceSelection extends Plugin {
   public $group;
 
   /**
-   * An array of entity types that can be referenced by this plugin. Defaults to
+   * An array of entity types that can be referenced by this plugin.
-   * all entity types.
+   *
+   * Defaults to all entity types.
    *
    * This property is optional and it does not need to be declared.
    *

core/lib/Drupal/Core/Entity/EntityDisplayBase.php

@@ -13,8 +13,7 @@ use Drupal\Core\Entity\Display\EntityDisplayInterface;
 abstract class EntityDisplayBase extends ConfigEntityBase implements EntityDisplayInterface {
 
   /**
-   * The 'mode' for runtime EntityDisplay objects used to render entities with
+   * The mode used to render entities with arbitrary display options.
-   * arbitrary display options rather than a configured view mode or form mode.
    *
    * @todo Prevent creation of a mode with this ID
    *   https://www.drupal.org/node/2410727
@@ -57,8 +56,10 @@ abstract class EntityDisplayBase extends ConfigEntityBase implements EntityDispl
   protected $mode = self::CUSTOM_MODE;
 
   /**
-   * Whether this display is enabled or not. If the entity (form) display
+   * Whether this display is enabled or not.
-   * is disabled, we'll fall back to the 'default' display.
+   *
+   * If the entity (form) display is disabled, we'll fall back to the 'default'
+   * display.
    *
    * @var bool
    */
@@ -79,8 +80,10 @@ abstract class EntityDisplayBase extends ConfigEntityBase implements EntityDispl
   protected $hidden = [];
 
   /**
-   * The original view or form mode that was requested (case of view/form modes
+   * The original view or form mode that was requested.
-   * being configured to fall back to the 'default' display).
+   *
+   * Case of view/form modes being configured to fall back to the 'default'
+   * display.
    *
    * @var string
    */

core/lib/Drupal/Core/Entity/EntityFieldManager.php

@@ -63,8 +63,10 @@ class EntityFieldManager implements EntityFieldManagerInterface {
   protected $activeFieldStorageDefinitions;
 
   /**
-   * An array keyed by entity type. Each value is an array whose keys are
+   * An array of lightweight maps of fields, keyed by entity type.
-   * field names and whose value is an array with two entries:
+   *
+   * Each value is an array whose keys are field names and whose value is an
+   * array with two entries:
    *   - type: The field type.
    *   - bundles: The bundles in which the field appears.
    *
@@ -73,10 +75,11 @@ class EntityFieldManager implements EntityFieldManagerInterface {
   protected $fieldMap = [];
 
   /**
-   * An array keyed by field type. Each value is an array whose key are entity
+   * An array of lightweight maps of fields, keyed by field type.
-   * types including arrays in the same form that $fieldMap.
    *
-   * It helps access the mapping between types and fields by the field type.
+   * Each value is an array whose key are entity types including arrays in the
+   * same form as $fieldMap. It helps access the mapping between types and
+   * fields by the field type.
    *
    * @var array
    */

core/lib/Drupal/Core/Entity/Query/Sql/Query.php

@@ -41,8 +41,9 @@ class Query extends QueryBase implements QueryInterface {
   protected $sqlFields = [];
 
   /**
-   * An array of strings added as to the group by, keyed by the string to avoid
+   * An array of strings for the SQL 'group by' operation.
-   * duplicates.
+   *
+   * Array is keyed by the string to avoid duplicates.
    *
    * @var array
    */

core/lib/Drupal/Core/Entity/Sql/DefaultTableMapping.php

@@ -54,8 +54,9 @@ class DefaultTableMapping implements TableMappingInterface {
   protected $dataTable;
 
   /**
-   * The table that stores revision field data if the entity supports revisions
+   * The table that stores revision field data.
-   * and has multilingual support.
+   *
+   * Only used if the entity supports revisions and has multilingual support.
    *
    * @var string
    */

core/lib/Drupal/Core/Entity/SynchronizableEntityTrait.php

@@ -10,8 +10,7 @@ namespace Drupal\Core\Entity;
 trait SynchronizableEntityTrait {
 
   /**
-   * Whether this entity is being created, updated or deleted through a
+   * Is entity being created updated or deleted through synchronization process.
-   * synchronization process.
    *
    * @var bool
    */

core/lib/Drupal/Core/Field/Annotation/FieldFormatter.php

@@ -64,9 +64,10 @@ class FieldFormatter extends Plugin {
   public $field_types = [];
 
   /**
-   * An integer to determine the weight of this formatter relative to other
+   * An integer to determine the weight of this formatter.
-   * formatter in the Field UI when selecting a formatter for a given field
+   *
-   * instance.
+   * Weight is relative to other formatter in the Field UI when selecting a
+   * formatter for a given field instance.
    *
    * This property is optional and it does not need to be declared.
    *

core/lib/Drupal/Core/Field/Annotation/FieldWidget.php

@@ -70,8 +70,10 @@ class FieldWidget extends Plugin {
   public $multiple_values = FALSE;
 
   /**
-   * An integer to determine the weight of this widget relative to other widgets
+   * An integer to determine weight of this widget relative to other widgets.
-   * in the Field UI when selecting a widget for a given field.
+   *
+   * Other widgets are in the Field UI when selecting a widget for a given
+   * field.
    *
    * This property is optional and it does not need to be declared.
    *

core/lib/Drupal/Core/Field/FieldConfigBase.php

@@ -184,8 +184,10 @@ abstract class FieldConfigBase extends ConfigEntityBase implements FieldConfigIn
   protected $constraints = [];
 
   /**
-   * Array of property constraint options keyed by property ID. The values are
+   * Array of property constraint options keyed by property ID.
-   * associative array of constraint options keyed by constraint plugin ID.
+   *
+   * The values are associative array of constraint options keyed by constraint
+   * plugin ID.
    *
    * @var array[]
    */

core/lib/Drupal/Core/Field/Plugin/Field/FieldWidget/OptionsWidgetBase.php

@@ -24,8 +24,9 @@ use Drupal\Core\StringTranslation\TranslatableMarkup;
 abstract class OptionsWidgetBase extends WidgetBase {
 
   /**
-   * Abstract over the actual field columns, to allow different field types to
+   * Abstract over the actual field columns.
-   * reuse those widgets.
+   *
+   * Allows different field types to reuse those widgets.
    *
    * @var string
    */

core/lib/Drupal/Core/Form/FormState.php

@@ -36,9 +36,10 @@ class FormState implements FormStateInterface {
   protected $complete_form;
 
   /**
-   * An associative array of information stored by Form API that is necessary to
+   * An associative array of information stored by Form API.
-   * build and rebuild the form from cache when the original context may no
+   *
-   * longer be available:
+   * This associative array is necessary to build and rebuild the form from
+   * cache when the original context may no longer be available:
    *   - callback: The actual callback to be used to retrieve the form array.
    *     Can be any callable. If none is provided $form_id is used as the name
    *     of a function to call instead.
@@ -70,8 +71,9 @@ class FormState implements FormStateInterface {
   ];
 
   /**
-   * Similar to self::$build_info, but pertaining to
+   * Similar to self::$build_info.
-   * \Drupal\Core\Form\FormBuilderInterface::rebuildForm().
+   *
+   * But pertaining to \Drupal\Core\Form\FormBuilderInterface::rebuildForm().
    *
    * This property is uncacheable.
    *
@@ -80,6 +82,8 @@ class FormState implements FormStateInterface {
   protected $rebuild_info = [];
 
   /**
+   * Determines whether the form is rebuilt.
+   *
    * Normally, after the entire form processing is completed and submit handlers
    * have run, a form is considered to be done and
    * \Drupal\Core\Form\FormSubmitterInterface::redirectForm() will redirect the
@@ -103,6 +107,8 @@ class FormState implements FormStateInterface {
   protected $rebuild = FALSE;
 
   /**
+   * Determines if only safe element value callbacks are called.
+   *
    * If set to TRUE the form will skip calling form element value callbacks,
    * except for a select list of callbacks provided by Drupal core that are
    * known to be safe.
@@ -116,6 +122,8 @@ class FormState implements FormStateInterface {
   protected $invalidToken = FALSE;
 
   /**
+   * The response object.
+   *
    * Used when a form needs to return some kind of a
    * \Symfony\Component\HttpFoundation\Response object, e.g., a
    * \Symfony\Component\HttpFoundation\BinaryFileResponse when triggering a
@@ -140,8 +148,9 @@ class FormState implements FormStateInterface {
   protected $redirect;
 
   /**
-   * If set to TRUE the form will NOT perform a redirect, even if
+   * If set to TRUE the form will NOT perform a redirect.
-   * self::$redirect is set.
+   *
+   * Redirect will not be performed, even if self::$redirect is set.
    *
    * This property is uncacheable.
    *
@@ -264,6 +273,8 @@ class FormState implements FormStateInterface {
   protected $always_process;
 
   /**
+   * Indicates if a validation will be forced.
+   *
    * Ordinarily, a form is only validated once, but there are times when a form
    * is resubmitted internally and should be validated again. Setting this to
    * TRUE will force that to happen. This is most likely to occur during Ajax
@@ -276,6 +287,8 @@ class FormState implements FormStateInterface {
   protected $must_validate;
 
   /**
+   * Indicates if the form was submitted programmatically.
+   *
    * If TRUE, the form was submitted programmatically, usually invoked via
    * \Drupal\Core\Form\FormBuilderInterface::submitForm(). Defaults to FALSE.
    *
@@ -284,6 +297,8 @@ class FormState implements FormStateInterface {
   protected $programmed = FALSE;
 
   /**
+   * Indicates if programmatic form submissions bypasses #access check.
+   *
    * If TRUE, programmatic form submissions are processed without taking #access
    * into account. Set this to FALSE when submitting a form programmatically
    * with values that may have been input by the user executing the current
@@ -295,6 +310,8 @@ class FormState implements FormStateInterface {
   protected $programmed_bypass_access_check = TRUE;
 
   /**
+   * Indicates correct form submission.
+   *
    * TRUE signifies correct form submission. This is always TRUE for programmed
    * forms coming from \Drupal\Core\Form\FormBuilderInterface::submitForm() (see
    * 'programmed' key), or if the form_id coming from the
@@ -323,10 +340,11 @@ class FormState implements FormStateInterface {
   protected $executed = FALSE;
 
   /**
-   * The form element that triggered submission, which may or may not be a
+   * The form element that triggered submission.
-   * button (in the case of Ajax forms). This key is often used to distinguish
+   *
-   * between various buttons in a submit handler, and is also used in Ajax
+   * This may or may not be a button (in the case of Ajax forms). This key is
-   * handlers.
+   * often used to distinguish between various buttons in a submit handler, and
+   * is also used in Ajax handlers.
    *
    * This property is uncacheable.
    *
@@ -335,6 +353,8 @@ class FormState implements FormStateInterface {
   protected $triggering_element;
 
   /**
+   * Indicates a file element is present.
+   *
    * If TRUE, there is a file element and Form API will set the appropriate
    * 'enctype' HTML attribute on the form.
    *
@@ -352,6 +372,8 @@ class FormState implements FormStateInterface {
   protected $groups = [];
 
   /**
+   * The storage.
+   *
    * This is not a special key, and no specific support is provided for it in
    * the Form API. By tradition it was the location where application-specific
    * data was stored for communication between the submit, validation, and form

core/lib/Drupal/Core/Password/PhpassHashedPassword.php

@@ -32,6 +32,8 @@ class PhpassHashedPassword implements PasswordInterface {
   public static $ITOA64 = './0123456789ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz';
 
   /**
+   * Password stretching iteration count.
+   *
    * Specifies the number of times the hashing function will be applied when
    * generating new password hashes. The number of times is calculated by
    * raising 2 to the power of the given value.

core/lib/Drupal/Core/Plugin/DefaultPluginManager.php

@@ -50,8 +50,9 @@ class DefaultPluginManager extends PluginManagerBase implements PluginManagerInt
   protected $alterHook;
 
   /**
-   * The subdirectory within a namespace to look for plugins, or FALSE if the
+   * The subdirectory within a namespace to look for plugins.
-   * plugins are in the top level of the namespace.
+   *
+   * Set to FALSE if the plugins are in the top level of the namespace.
    *
    * @var string|bool
    */
@@ -65,9 +66,10 @@ class DefaultPluginManager extends PluginManagerBase implements PluginManagerInt
   protected $moduleHandler;
 
   /**
-   * A set of defaults to be referenced by $this->processDefinition() if
+   * A set of defaults to be referenced by $this->processDefinition().
-   * additional processing of plugins is necessary or helpful for development
+   *
-   * purposes.
+   * Allows for additional processing of plugins when necessary or helpful for
+   * development purposes.
    *
    * @var array
    */
@@ -88,16 +90,20 @@ class DefaultPluginManager extends PluginManagerBase implements PluginManagerInt
   protected $pluginInterface;
 
   /**
-   * An object that implements \Traversable which contains the root paths
+   * An object of root paths that are traversable.
-   * keyed by the corresponding namespace to look for plugin implementations.
+   *
+   * The root paths are keyed by the corresponding namespace to look for plugin
+   * implementations.
    *
    * @var \Traversable
    */
   protected $namespaces;
 
   /**
-   * Additional namespaces the annotation discovery mechanism should scan for
+   * Additional annotation namespaces.
-   * annotation definitions.
+   *
+   * The annotation discovery mechanism should scan these for annotation
+   * definitions.
    *
    * @var string[]
    */

core/lib/Drupal/Core/Plugin/Discovery/AnnotatedClassDiscovery.php

@@ -11,6 +11,8 @@ use Drupal\Component\Annotation\Plugin\Discovery\AnnotatedClassDiscovery as Comp
 class AnnotatedClassDiscovery extends ComponentAnnotatedClassDiscovery {
 
   /**
+   * The directory suffix.
+   *
    * A suffix to append to each PSR-4 directory associated with a base
    * namespace, to form the directories where plugins are found.
    *
@@ -19,6 +21,8 @@ class AnnotatedClassDiscovery extends ComponentAnnotatedClassDiscovery {
   protected $directorySuffix = '';
 
   /**
+   * The namespace suffix.
+   *
    * A suffix to append to each base namespace, to obtain the namespaces where
    * plugins are found.
    *

core/lib/Drupal/Core/StreamWrapper/StreamWrapperInterface.php

@@ -82,11 +82,12 @@ interface StreamWrapperInterface extends PhpStreamWrapperInterface {
   const READ_VISIBLE = 0x0014;
 
   /**
-   * This is the default 'type' flag. This does not include
+   * The default 'type' flag.
-   * StreamWrapperInterface::LOCAL, because PHP grants a greater trust level to
+   *
-   * local files (for example, they can be used in an "include" statement,
+   * This does not include StreamWrapperInterface::LOCAL, because PHP grants a
-   * regardless of the "allow_url_include" setting), so stream wrappers need to
+   * greater trust level to local files (for example, they can be used in an
-   * explicitly opt-in to this.
+   * "include" statement, regardless of the "allow_url_include" setting), so
+   * stream wrappers need to explicitly opt-in to this.
    */
   const NORMAL = 0x001C;
 

core/lib/Drupal/Core/Template/TwigSandboxPolicy.php

@@ -25,8 +25,9 @@ class TwigSandboxPolicy implements SecurityPolicyInterface {
   protected $allowed_methods;
 
   /**
-   * An array of allowed method prefixes -- any method starting with one of
+   * Allowed method prefixes.
-   * these prefixes will be allowed.
+   *
+   * Any method starting with one of these prefixes will be allowed.
    *
    * @var array
    */

core/lib/Drupal/Core/Test/TestDatabase.php

@@ -12,6 +12,8 @@ use Drupal\Core\Database\Database;
 class TestDatabase {
 
   /**
+   * The test lock ID.
+   *
    * A random number used to ensure that test fixtures are unique to each test
    * method.
    *

core/lib/Drupal/Core/Validation/Annotation/Constraint.php

@@ -38,10 +38,11 @@ class Constraint extends Plugin {
   public $label;
 
   /**
-   * An array of DataType plugin IDs for which this constraint applies. Valid
+   * DataType plugin IDs for which this constraint applies.
-   * values are any types registered by the typed data API, or an array of
+   *
-   * multiple type names. For supporting all types, FALSE may be specified. The
+   * Valid values are any types registered by the typed data API, or an array
-   * key defaults to an empty array, which indicates no types are supported.
+   * of multiple type names. For supporting all types, FALSE may be specified.
+   * The key defaults to an empty array, which indicates no types are supported.
    *
    * @var string|string[]|false
    *

core/modules/block/src/Plugin/migrate/process/BlockVisibility.php

@@ -34,8 +34,9 @@ class BlockVisibility extends ProcessPluginBase implements ContainerFactoryPlugi
   protected $migrateLookup;
 
   /**
-   * Whether or not to skip blocks that use PHP for visibility. Only applies
+   * Whether or not to skip blocks that use PHP for visibility.
-   * if the PHP module is not enabled.
+   *
+   * Only applies if the PHP module is not enabled.
    *
    * @var bool
    */

core/modules/content_translation/src/ContentTranslationHandler.php

@@ -78,8 +78,9 @@ class ContentTranslationHandler implements ContentTranslationHandlerInterface, E
   protected $currentUser;
 
   /**
-   * The array of installed field storage definitions for the entity type, keyed
+   * Installed field storage definitions for the entity type.
-   * by field name.
+   *
+   * Keyed by field name.
    *
    * @var \Drupal\Core\Field\FieldStorageDefinitionInterface[]
    */

core/modules/editor/src/Entity/Editor.php

@@ -36,8 +36,7 @@ use Drupal\editor\EditorInterface;
 class Editor extends ConfigEntityBase implements EditorInterface {
 
   /**
-   * The machine name of the text format with which this configured text editor
+   * Machine name of the text format for this configured text editor.
-   * is associated.
    *
    * @var string
    *

core/modules/editor/tests/src/Functional/EditorSecurityTest.php

@@ -62,8 +62,7 @@ class EditorSecurityTest extends BrowserTestBase {
   protected $normalUser;
 
   /**
-   * User with access to Restricted HTML text format, dangerous tags allowed
+   * User with access to Restricted HTML and tags considered dangerous.
-   * with text editor.
    *
    * @var \Drupal\user\UserInterface
    */

core/modules/field/tests/src/Functional/Views/FieldTestBase.php

@@ -34,8 +34,7 @@ abstract class FieldTestBase extends ViewTestBase {
   public $fieldStorages;
 
   /**
-   * Stores the fields of the field storage. They have the same keys as the
+   * Stores the fields of the field storage.
-   * field storages.
    *
    * @var array
    */

core/modules/field/tests/src/FunctionalJavascript/EntityReference/EntityReferenceAdminTest.php

@@ -49,8 +49,7 @@ class EntityReferenceAdminTest extends WebDriverTestBase {
   protected $type;
 
   /**
-   * The name of a second content type to be used as a target of entity
+   * Name of a second content type to be used as a target of entity references.
-   * references.
    *
    * @var string
    */

core/modules/locale/locale.module

@@ -117,14 +117,16 @@ const LOCALE_TRANSLATION_STATUS_TTL = 600;
 const LOCALE_TRANSLATION_OVERWRITE_ALL = 'all';
 
 /**
- * UI option for override of existing translations. Only override non-customized
+ * UI option for override of existing translations.
- * translations.
+ *
+ * Only override non-customized translations.
  */
 const LOCALE_TRANSLATION_OVERWRITE_NON_CUSTOMIZED = 'non_customized';
 
 /**
- * UI option for override of existing translations. Don't override existing
+ * UI option for override of existing translations.
- * translations.
+ *
+ * Don't override existing translations.
  */
 const LOCALE_TRANSLATION_OVERWRITE_NONE = 'none';
 

core/modules/locale/tests/src/Functional/LocaleImportFunctionalTest.php

@@ -35,8 +35,7 @@ class LocaleImportFunctionalTest extends BrowserTestBase {
   protected $adminUser;
 
   /**
-   * A user able to create languages, import translations and access site
+   * A user able to create languages, import translations, access site reports.
-   * reports.
    *
    * @var \Drupal\user\Entity\User
    */

core/modules/rest/tests/src/Functional/EntityResource/EntityResourceTestBase.php

@@ -85,6 +85,8 @@ abstract class EntityResourceTestBase extends ResourceTestBase {
   protected static $patchProtectedFieldNames;
 
   /**
+   * The unique field names.
+   *
    * The fields that need a different (random) value for each new entity created
    * by a POST request.
    *
@@ -93,6 +95,8 @@ abstract class EntityResourceTestBase extends ResourceTestBase {
   protected static $uniqueFieldNames = [];
 
   /**
+   * The field name for the label.
+   *
    * Optionally specify which field is the 'label' field. Some entities do not
    * specify a 'label' entity key. For example: User.
    *

core/modules/taxonomy/src/TermStorage.php

@@ -40,8 +40,7 @@ class TermStorage extends SqlContentEntityStorage implements TermStorageInterfac
   protected $trees = [];
 
   /**
-   * Array of all loaded term ancestry keyed by ancestor term ID, keyed by term
+   * Term ancestry keyed by ancestor term ID, keyed by term ID.
-   * ID.
    *
    * @var \Drupal\taxonomy\TermInterface[][]
    */

core/modules/views/src/Plugin/views/HandlerBase.php

@@ -45,6 +45,8 @@ abstract class HandlerBase extends PluginBase implements ViewsHandlerInterface {
   public $tableAlias;
 
   /**
+   * The real field.
+   *
    * The actual field in the database table, maybe different
    * on other kind of query plugins/special handlers.
    *

core/modules/views/src/Plugin/views/argument/ArgumentPluginBase.php

@@ -71,9 +71,11 @@ abstract class ArgumentPluginBase extends HandlerBase implements CacheableDepend
   public string $name_table_alias;
 
   /**
-   * The field to use for the name to use in the summary, which is
+   * The field to use for the name to display in the summary.
-   * the displayed output. For example, for the node: nid argument,
+   *
-   * the argument itself is the nid, but node.title is displayed.
+   * For example, for the node: nid argument, the argument itself is the nid,
+   * but node.title is displayed.
+   *
    * @var string
    */
   public $name_field;
@@ -531,6 +533,8 @@ abstract class ArgumentPluginBase extends HandlerBase implements CacheableDepend
   }
 
   /**
+   * Default actions.
+   *
    * Provide a list of default behaviors for this argument if the argument
    * is not present.
    *

core/modules/views/src/Plugin/views/filter/FilterPluginBase.php

@@ -46,6 +46,8 @@ use Drupal\views\ViewExecutable;
 abstract class FilterPluginBase extends HandlerBase implements CacheableDependencyInterface {
 
   /**
+   * The value.
+   *
    * Contains the actual value of the field,either configured in the views ui
    * or entered in the exposed filters.
    */

core/modules/views/src/Plugin/views/query/Sql.php

@@ -41,21 +41,26 @@ class Sql extends QueryPluginBase {
   public $tables = [];
 
   /**
-   * Holds an array of relationships, which are aliases of the primary
+   * Holds an array of relationships.
-   * table that represent different ways to join the same table in.
+   *
+   * These are aliases of the primary table that represent different ways to
+   * join the same table in.
    */
   public $relationships = [];
 
   /**
-   * An array of sections of the WHERE query. Each section is in itself
+   * An array of sections of the WHERE query.
-   * an array of pieces and a flag as to whether or not it should be AND
+   *
-   * or OR.
+   * Each section is in itself an array of pieces and a flag as to whether or
+   * not it should be AND or OR.
    */
+
   public $where = [];
   /**
-   * An array of sections of the HAVING query. Each section is in itself
+   * An array of sections of the HAVING query.
-   * an array of pieces and a flag as to whether or not it should be AND
+   *
-   * or OR.
+   * Each section is in itself an array of pieces and a flag as to whether or
+   * not it should be AND or OR.
    */
   public $having = [];
 

core/modules/views_ui/src/ViewUI.php

@@ -122,8 +122,9 @@ class ViewUI implements ViewEntityInterface {
   ];
 
   /**
-   * Whether the config is being created, updated or deleted through the
+   * Whether the config is being synced through the import process.
-   * import process.
+   *
+   * This is the case with create, update or delete.
    *
    * @var bool
    */