[wp-trac] [WordPress Trac] #33701: Standardize core file headers

[WordPress Trac]

#33701: Standardize core file headers
--------------------------+---------------------------
 Reporter:  DrewAPicture  |       Owner:  DrewAPicture
     Type:  defect (bug)  |      Status:  accepted
 Priority:  normal        |   Milestone:  4.4
Component:  General       |     Version:
 Severity:  normal        |  Resolution:
 Keywords:  has-patch     |     Focuses:  docs
--------------------------+---------------------------

Comment (by GaryJ):

 I'd like to see this consistency applied to the empty `index.php` files
 found inside `wp-content`, `plugins`, and `themes` too. Currently there is
 just the following for each:

 {{{
 <?php
 // Silence is golden.

 }}}

 It could be made a little less cryptic for those viewing the files, and
 adhering to code standards with something like:

 {{{
 <?php
 /**
  * Intentionally empty file
  *
  * This file exists to stop directory listings on poorly configured
 servers.
  */

 }}}

 The Summary could be adapted for each `index.php` to include the reference
 to which directory it is in, to avoid duplicate Summaries. The `@package`
 and other tags may be added if this has any value for wp-parser.

--
Ticket URL: <https://core.trac.wordpress.org/ticket/33701#comment:21>
WordPress Trac <https://core.trac.wordpress.org/>
WordPress publishing platform