WordPress.org

Making WordPress.org

Opened 7 weeks ago

Last modified 3 weeks ago

#3233 reopened defect

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

Reported by: mp518 Owned by:
Milestone: Priority: normal
Component: Support Forums Keywords: has-patch
Cc:

Description

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

Attachments (1)

3233.patch (1.3 KB) - added by mp518 7 weeks ago.
correct

Download all attachments as: .zip

Change History (4)

@mp518
7 weeks ago

correct

#1 follow-up: @Otto42
7 weeks ago

  • Milestone Plugin Directory v3.0 deleted
  • Resolution set to invalid
  • Status changed from new to closed

#2 in reply to: ↑ 1 ; follow-up: @netweb
7 weeks ago

  • Resolution invalid deleted
  • Status changed from closed to reopened

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:

#3 in reply to: ↑ 2 @mp518
3 weeks ago

Agree with you @netweb

Note: See TracTickets for help on using tickets.