[wp-trac] [WordPress Trac] #33297: Various typos and punctuation errors in wp/admin/edit-form-advanced.php - help tab.

[WordPress Trac]

#33297: Various typos and punctuation errors in wp/admin/edit-form-advanced.php -
help tab.
--------------------------------------------------+------------------
 Reporter:  timph                                 |       Owner:
     Type:  defect (bug)                          |      Status:  new
 Priority:  normal                                |   Milestone:  4.4
Component:  General                               |     Version:  4.3
 Severity:  normal                                |  Resolution:
 Keywords:  good-first-bug has-patch 2nd-opinion  |     Focuses:
--------------------------------------------------+------------------

Comment (by timph):

 I agree with @netweb on the verbiage after rereading this again, but it
 would lead me back to the point I was attempting to make - that it could
 be worded better.  If it takes a group of people rereading it several
 times for comprehension, then it's probably not conveying the message it
 should in the best possible way.

 The section "the Screen Options tab" seems more apparent now that it's
 meant to be more of a parenthetical expression. It mislead me when reading
 it from a contextual point of view without actually paying attention to
 what was being said.  It's like a list of adverb phrases with a
 parenthetical expression interrupting it.  From just a 'style' standpoint
 - I'd usually say to try to use some -'s as they are a more forceful way
 to separate out a parenthetical expression in the middle of a list.
 Overuse of commas can be confusing to those who use automated readers that
 might have extended pauses in between each comma thinking it's a list -
 much as I did!

 Original:

 Flesch-Kincaid Reading Ease     55.3 - Grade Level 14.2
 Creating a Page is very similar to creating a Post, and the screens can be
 customized in the same way using drag and drop, the Screen Options tab,
 and expanding/collapsing boxes as you choose.

 Revised:

 Flesch-Kincaid Reading Ease 71.6    - Grade Level 7.2:
 Creating a Page is very similar to creating a Post. You can use the Screen
 Options tab to customize the screens using drag and drop, and
 expanding/collapsing them as you choose.

 Flesch-Kincaid tests, while not overly accurate, are a good reference
 point - at the very least.  A general target audience should fall below
 grade level 8 to be considered easy to read to the vast majority.

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