Problem/Motivation
#2701027: Drupal 8 UPGRADE.txt is misleading in many ways (in its name to begin with) removed a serial (Oxford) comma from README.txt. Our text guidelines require them: https://www.drupal.org/drupalorg/style-guide/content#english
Proposed resolution
Add it back so that it says:
Install, update, and maintain Drupal:
(I debated whether we should scope this as "Add serial commas where they are missing" but @alexpott and I agreed that it's not something that's testable, that we might as well just fix this small regression since it just happened, and also it's not in a PHP comment but a text file.)
Remaining tasks
Needs patch.
User interface changes
N/A
API changes
N/A
Data model changes
N/A
Comment | File | Size | Author |
---|---|---|---|
#3 | add_back_serial_comma-2707095-3.patch | 495 bytes | richardbporter |
Comments
Comment #2
richardbporter CreditAttribution: richardbporter as a volunteer commentedComment #3
richardbporter CreditAttribution: richardbporter as a volunteer commentedComment #4
richardbporter CreditAttribution: richardbporter as a volunteer commentedComment #5
richardbporter CreditAttribution: richardbporter as a volunteer commentedComment #6
jhodgdonThanks!
I read through the README, since I hadn't looked at it in a while, and there are no other serial comma problems.
I did notice that the develop section is woefully outdated, and will file a separate issue in the documentation component about that, but it's not related to this issue.
Comment #7
Wim LeersComment #8
alexpottRC eligible as a doc change. Committed f870de1 and pushed to 8.1.x and 8.2.x. Thanks!
Comment #11
richardbporter CreditAttribution: richardbporter as a volunteer commentedThanks! :)