diff --git a/en-US/A.xml b/en-US/A.xml index 75cf57e..5b4dcf8 100644 --- a/en-US/A.xml +++ b/en-US/A.xml @@ -94,22 +94,14 @@ - a.m. - + AM - - Use lowercase with periods, such as "11 a.m.". Use a nonbreaking space between the numeral and "a.m.". - - + For times of day, use uppercase without periods, and use a preceding nonbreaking space after the numeral, for example "11 AM". + See also . - diff --git a/en-US/Language.xml b/en-US/Language.xml index 22aec39..6a76d1d 100644 --- a/en-US/Language.xml +++ b/en-US/Language.xml @@ -1265,25 +1265,23 @@ Numbers (move from N entry) --> Exception: Use of an all-numeric representation is allowed when space is limited, as in a user interface, or to enhance readability. In such cases, use the ISO date format with a 4-digit year (YYYY-MM-DD) and define the format in a header or legend. - For times of day, use lowercase with periods, such as "11 a.m.". Use a nonbreaking space between the numeral and "a.m." or "p.m.". - - + - Use "noon" or "12 noon" instead of "12 p.m.". - Use "midnight" or "12 midnight" instead of "12 a.m.". + Use "noon" or "12 noon" instead of "12 PM". + Use "midnight" or "12 midnight" instead of "12 AM". Examples - The training class begins at 10 a.m. on 1 April 2021. + The training class begins at 10 AM on 1 April 2021. + + - The coffee break is from 2:00 p.m. to 2:30 p.m. + The coffee break is from 2:00 PM to 2:30 PM. diff --git a/en-US/P.xml b/en-US/P.xml index 52325fd..31aa693 100644 --- a/en-US/P.xml +++ b/en-US/P.xml @@ -121,21 +121,14 @@ - p.m. + PM - - Use lowercase with periods, such as "2 p.m.". Use a nonbreaking space between the numeral and "p.m.". - - + For times of day, use uppercase without periods, and use a preceding nonbreaking space after the numeral, for example "2 PM". + See also . - diff --git a/en-US/rel_notes.md b/en-US/rel_notes.md new file mode 100644 index 0000000..1781a79 --- /dev/null +++ b/en-US/rel_notes.md @@ -0,0 +1,25 @@ +# Red Hat Style Guide: Version 5.0 Release Notes, July 2021 + +Changed guide title to “Red Hat Technical Writing Style Guide”. Changed subtitle to “Style Conventions for Writers and Editors”. + +Added inclusive language guidance. + +Added section on use of relative pronoun “that”. + +Added sections on exclamation points and referring to punctuation marks. + +Clarified that sentence case is required for captions, legends, and diagram labels. + +Added section on phrasal verbs (two-word verb forms). + +Added more categories of ambiguities to avoid. + +Dates and Times: Changed times of day standard from “a.m.”, “p.m.” to “AM”, “PM”. + +Usage A-Z added entries: appendixes, as long as, blacklist, colocate/colocation, display, following, i.e., indexes, login/log in/log in to, master, sign in/sign in to, slave, whitelist, wish + +Updated entries: backwards-compatible, high-availability, hostname, lifecycle, OK, please, setup, username, ZIP Code + +Removed guidance about DocBook and markup, to focus instead on writing. + +Minor edits so the guide itself conforms more fully with its own advice. \ No newline at end of file