Make WordPress Core

Changes between Version 1 and Version 2 of Ticket #53875


Ignore:
Timestamp:
08/04/2021 09:16:59 PM (5 years ago)
Author:
johnjamesjacoby
Comment:

Legend:

Unmodified
Added
Removed
Modified
  • Ticket #53875 – Description

    v1 v2  
    1212}}}
    1313
    14 Further emphasis is put on not using `/**` specifically:
     14The docs put emphasis on not using `/**` specifically:
    1515
    1616> Important note: Multi-line comments must not begin with `/**` (double asterisk) as the parser might mistake it for a DocBlock. Use `/*` (single asterisk) instead.
     17
     18It's worth emphasizing here that it does not say ''single-line'' comments shouldn't use `/**` but the handbook docs do not explain (that I have found) when and why single-line comments should use `/**`. This same syntax is also used when hooks are used in multiple locations, for example.
    1719
    1820According to our own standard, I believe these lines should instead be: