Allow contractions #329

Author: dariavladykina

xml/docu_styleguide.language.xml

@@ -224,8 +224,11 @@
   <section xml:id="sec-contraction">
     <title>Contractions</title>
     <para>
-      Do not use contractions (such as <quote>don't</quote>), unless you are
-      purposefully writing a casual document.
+      You may use common contractions (such as <quote>don’t,</quote> <quote>it’s</quote> 
+      or <quote>we’ll</quote>) to make your writing more natural and conversational. 
+      Contractions improve readability and engagement by reflecting how people 
+      speak. Be consistent: do not mix a contraction (for example, <quote>can’t</quote>) 
+      with its fully spelled form (<quote>cannot</quote>) in the same document.
     </para>
   </section>
   <section xml:id="sec-dash">
@@ -517,9 +520,10 @@
   <section xml:id="sec-tone">
     <title>Tone and voice</title>
     <para>
-      Maintain a professional tone. Do not use contractions, except in casual
-      documents. Do not use humor. Be honest and avoid absolutes and
-      exaggerations, but focus on positive aspects.
+      Maintain a professional tone that is helpful and honest. Do not use 
+      humor, and avoid absolutes or exaggerations; instead, 
+      focus on positive aspects and factual accuracy. Contractions 
+      are permitted to keep the writing engaging and conversational.
     </para>
     <para>
       Use the second person (<quote>you</quote>) to refer to the reader.