Merge pull request #425 from rolfedh/add-previously

Add guidance to avoid using "now" and "previously" in release notes

Author: mportman12

supplementary_style_guide/glossary_terms_conventions/general_conventions/n.adoc

@@ -71,7 +71,7 @@
 
 *Incorrect forms*: natively-compiled code
 
-*See also*: 
+*See also*:
 
 [[need]]
 ==== image:images/yes.png[yes] need (verb)
@@ -189,11 +189,13 @@
 *See also*:
 
 [[now]]
-==== image:images/yes.png[yes] now (adverb)
-*Description*: "Now" means at the present time, immediately, or at once.
+==== image:images/caution.png[caution] now (adverb)
+*Description*: In most content, you can use "now" when you mean the present time, immediately, or at once.
 
-*Use it*: yes
+If your release notes are based on the templates in this guide's xref:release-notes[Release notes] section, use "with this update" rather than "now" to refer to the current release. This is because the temporal context of "now"  can cause confusion in release notes that span multiple releases.
+
+*Use it*: with caution
 
 *Incorrect forms*: right now
 
-*See also*:
+*See also*: xref:release-notes[Release notes]

supplementary_style_guide/glossary_terms_conventions/general_conventions/p.adoc

@@ -381,6 +381,19 @@ Use "plugin" rather than "plug-in", unless you are updating existing content tha
 
 *See also*:
 
+[[previously]]
+==== image:images/caution.png[caution] Previously (adverb)
+*Description*: In most content, you can use "previously" to refer to something that was true or in effect at an earlier time but is no longer true or in effect now.
+
+If your release notes are based on the templates in this guide's xref:release-notes[Release notes] section, use "before this update" rather than "previously" to refer to the current release. This is because the temporal context of "previously"  can cause confusion in release notes that span multiple releases.
+
+*Use it*: with caution
+
+*Incorrect forms*:
+
+*See also*: xref:release-notes[Release notes]
+
+
 // Fuse: Added "In Red Hat Fuse," and moved "in a Camel route" to the end of the sentence
 [[processor]]
 ==== image:images/yes.png[yes] processor (noun)