[wp-trac] [WordPress Trac] #53028: Inconsistent Capitalisation

WordPress Trac noreply at wordpress.org
Tue Jun 8 15:24:51 UTC 2021


#53028: Inconsistent Capitalisation
-------------------------------------------------+-------------------------
 Reporter:  Presskopp                            |       Owner:  audrasjb
     Type:  defect (bug)                         |      Status:  accepted
 Priority:  normal                               |   Milestone:  5.8
Component:  Text Changes                         |     Version:
 Severity:  normal                               |  Resolution:
 Keywords:  good-first-bug has-patch needs-      |     Focuses:
  refresh                                        |
-------------------------------------------------+-------------------------

Comment (by desrosj):

 Reviewing this, I'm not sure that the preferred change is to always
 capitalize "documentation". I personally wouldn't consider "documentation"
 to be a proper noun.

 All instances of `Documentation URL` in Core that I can find are at the
 beginning of a sentence, and all instances of `documentation URL` are
 found within sentences, so these seem to be correct. `Documentation page`
 also has 6 lowercase instances and no capitalized, which also seems to be
 correct.

 Below is my findings on the other strings:
 - Documentation link: 1 capitalized mid sentence, 7 lowercase
 - Documentation link(s): 1 capitalized mid sentence, 7 lowercase
 - Documentation menu: 1 capitalized mid sentence
 - Documentation dropdown: 1 capitalized mid sentence
 - Site URL: 3 incorrectly capitalized mid sentence, 54 correctly lower
 cased mid sentence.
 - Website URL: 2 instances lower cased as translation context.

 The more common pattern that matches what I would expect to see is only
 capitalized when the first word of a sentence, label, or translation
 string/context, and lowercase everywhere else.

 Today is the beta 1 deadline for 5.8. If someone is able to refresh the
 patch in the next ~6 hours, we can get this one in. But otherwise I will
 punt to 5.9 to allow more time.

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


More information about the wp-trac mailing list