doc: add clarity to rule msg tips

Signed-off-by: jason taylor <jtfas90@gmail.com>

diff --git a/doc/userguide/rules/meta.rst b/doc/userguide/rules/meta.rst
index dc1fbd01164ac04f8d69ea1d470e4d994cea2dab..f8593a001a09fb8b958549648cfa039f27c9e57c 100644 (file)
--- a/doc/userguide/rules/meta.rst
+++ b/doc/userguide/rules/meta.rst
@@ -26,9 +26,9 @@ To continue the example of the previous chapter, this is the keyword in action i
 
 .. tip::
 
-   It is convention to make the first part of the signature uppercase and show the class of the signature.
+   It is a standard practice in rule writing to make the first part of the signature uppercase and to indicate the class of the signature.
 
-   It is also convention that ``msg`` is made the first keyword in the signature.
+   It is also a standard practice that ``msg`` is the first keyword in the signature.
 
 .. note:: The following characters must be escaped inside the msg:
              ``;`` ``\`` ``"``