From eb40bcf5aea0e644a5a652c32758442a737d9866 Mon Sep 17 00:00:00 2001 From: Julian Cable Date: Tue, 1 Feb 2022 17:29:56 +0000 Subject: [PATCH 1/2] 287 Add release notes --- en-US/New.xml | 72 +++++++++++++++++++ en-US/O.xml | 2 +- en-US/Preface.xml | 3 + ...le_Conventions_for_Writers_and_Editors.ent | 4 +- ...le_Conventions_for_Writers_and_Editors.xml | 10 +-- 5 files changed, 83 insertions(+), 8 deletions(-) create mode 100644 en-US/New.xml diff --git a/en-US/New.xml b/en-US/New.xml new file mode 100644 index 0000000..7772960 --- /dev/null +++ b/en-US/New.xml @@ -0,0 +1,72 @@ + + +%BOOK_ENTITIES; +]> +
+ New in This Release + + New in Release 5.1, January 2022 + Minor update to address some reported issues: + + + + Accessing IBM Style online. + + + Updated guidance for long commands. + + + Updated guidance for referring to object names. + + + Updated guidance for non-breaking spaces. + + + Updated guidance for punctuation with quotation marks. + + + The gerund verb form is no longer required in section titles. + + + Pronouncing file or directory names that begin with special characters. + + + Avoid "the product allows the user to do xyz". + + + Avoid consecutive headings. + + + Guidance to refer to UI elements and to other publication titles. + + + Clarification that diagram labels use sentence case. + + + New or updated usage entries: backend, IaC, number sign, on premise/on-premise, prebaked, unset. + + + + + New in Release 5.0, July 2021 + Major update to align with some recent changes in IBM Style: + + + + Sentence case is required for captions, legends, and diagram labels. + + + Punctuation: Added sections on referring to punctuation marks and names of punctuation marks and special characters. + + + Rename Chapter 4 to "Choosing Appropriate Language": expand scope beyond slang and jargon, to cover inclusive language; avoiding ambiguities (moved from Chapter 2 and added more categories); dates and times (AM and PM are now written in uppercase without periods); and numbers. + + + Usage A-Z: Various additions and updates. Corrected alphabetical sorting sequence. Moved items that are not literal term entries to an earlier chapter. + + + Minor edits so the guide itself conforms with its own advice. + + +
diff --git a/en-US/O.xml b/en-US/O.xml index 5b05a69..6bffc0d 100644 --- a/en-US/O.xml +++ b/en-US/O.xml @@ -111,7 +111,7 @@ - on premise + on premise, on-premise adverb diff --git a/en-US/Preface.xml b/en-US/Preface.xml index b356255..37932d5 100644 --- a/en-US/Preface.xml +++ b/en-US/Preface.xml @@ -5,6 +5,9 @@ ]> Preface + + + diff --git a/en-US/Style_Conventions_for_Writers_and_Editors.ent b/en-US/Style_Conventions_for_Writers_and_Editors.ent index 87f791a..a9587a6 100644 --- a/en-US/Style_Conventions_for_Writers_and_Editors.ent +++ b/en-US/Style_Conventions_for_Writers_and_Editors.ent @@ -1,5 +1,5 @@ - + - \ No newline at end of file + \ No newline at end of file diff --git a/en-US/Style_Conventions_for_Writers_and_Editors.xml b/en-US/Style_Conventions_for_Writers_and_Editors.xml index 012de66..8c5b4b0 100644 --- a/en-US/Style_Conventions_for_Writers_and_Editors.xml +++ b/en-US/Style_Conventions_for_Writers_and_Editors.xml @@ -59,15 +59,15 @@ - + From 4c6ea37482d040d5aca8611306c1adbd4ef8e967 Mon Sep 17 00:00:00 2001 From: Julian Cable Date: Wed, 2 Feb 2022 09:25:44 +0000 Subject: [PATCH 2/2] 287 Minor change to release wording --- en-US/New.xml | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/en-US/New.xml b/en-US/New.xml index 7772960..9a1a58e 100644 --- a/en-US/New.xml +++ b/en-US/New.xml @@ -6,8 +6,8 @@
New in This Release - New in Release 5.1, January 2022 - Minor update to address some reported issues: + Release 5.1 + Minor update in January 2022 to address some reported issues: @@ -49,8 +49,8 @@ - New in Release 5.0, July 2021 - Major update to align with some recent changes in IBM Style: + Release 5.0 + Major update in July 2021 to align with some recent changes in IBM Style: