[wp-trac] [WordPress Trac] #35417: Audit "blog" usage in inline docs

[WordPress Trac]

#35417: Audit "blog" usage in inline docs
--------------------------------+------------------------------
 Reporter:  ericlewis           |       Owner:
     Type:  defect (bug)        |      Status:  new
 Priority:  normal              |   Milestone:  4.5
Component:  Networks and Sites  |     Version:
 Severity:  normal              |  Resolution:
 Keywords:  dev-feedback        |     Focuses:  docs, multisite
--------------------------------+------------------------------

Comment (by DrewAPicture):

 Replying to [comment:18 ericlewis]:
 > I've removed the `good-first-bug` because I think some hard decisions
 need to be made with some of what's left.
 >
 > Should we call
 [https://github.com/WordPress/WordPress/blob/22467e840fd4ad9d41357a705078955a2d70112d
 /wp-includes/wp-db.php#L243 $wpdb->blogid Site ID]?
 [https://github.com/WordPress/WordPress/blob/22467e840fd4ad9d41357a705078955a2d70112d
 /wp-includes/wp-db.php#L417 Multisite "sites" table]?
 [https://github.com/WordPress/WordPress/blob/22467e840fd4ad9d41357a705078955a2d70112d
 /wp-includes/wp-db.php#L935 site prefix]?
 >
 > Similarly in the caching API, e.g.
 [https://github.com/WordPress/WordPress/blob/22467e840fd4ad9d41357a705078955a2d70112d
 /wp-includes/cache.php#L205 referring to "blog cache groups"]. Should
 these be site cache groups?
 >
 > I ask because some of these terms are so ingrained in our nomenclature.
 I'm leaning towards changing all of them, which will hopefully change the
 vocabulary we use. e.g. I think "site prefix" is a more usable term than
 "blog prefix."
 >

 I think changing the above just to change them for consistency isn't a
 great reason. As you cited, the nomenclature is pretty ingrained at this
 point.

 Either way, I think the spirit of the ticket has been fulfilled. If you
 don't think so, feel free to punt to future release.

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