Inline comments must end in full-stops,exclamation marks, or question marks missing wp standard in doc

[mp518]

Inline comments must end in full-stops,exclamation marks, or question marks as per WordPress standard.

[mp518]

correct

[Otto42]

The WordPress standard has no such rule.

​https://make.wordpress.org/core/handbook/best-practices/inline-documentation-standards/php/#5-inline-comments

[netweb]

Replying to Otto42:

The WordPress standard has no such rule.

​https://make.wordpress.org/core/handbook/best-practices/inline-documentation-standards/php/#5-inline-comments
​https://make.wordpress.org/core/handbook/best-practices/inline-documentation-standards/php/#5-1-single-line-comments

It does actually, the example given // Allow plugins to filter an array. includes a full-stop at the end of the line, it is also enforced by the ​WordPress PHPCS ruleset.

Also:

• ​https://make.wordpress.org/core/handbook/best-practices/inline-documentation-standards/php/#1-functions-class-methods:
  • > @param: Note if the parameter is Optional before the description, and include a period at the end. The description should mention accepted values as well as the default. For example: Optional. This value does something. Accepts ‘post’, ‘term’, or empty. Default empty.
  • > @return: Should contain all possible return types, and a description for each. Use a period at the end. Note: @return void should not be used outside of the default bundled themes.

[mp518]

Agree with you @netweb

[obenland]

In 7293:

Forums: Add trailing period to comments.

Props mp518.
Fixes #3233.