--- doc/docbase/writing_docs/01_writing_docs.html	2015/04/29 01:28:04	2746
+++ doc/docbase/writing_docs/01_writing_docs.html	2015/04/29 10:41:20	2747
@@ -501,13 +501,16 @@
       Syntax highlighting is automatically generated for you. That way you don't
       have to waste time on how to display source code nicely, and rather
       concentrate on the content of your article instead. 
-      You should provide the intended programming language with <code>??language??</code>.
-      Obviously it is exhausting to provide such a <code lang="none">lang</code>
-      attribute with every single code sample, especially if you are just refering
+      You should provide the intended programming language of your source code sample
+      with <code>??language??</code>.
+      Obviously it is exhausting to supply such a <code lang="none">lang</code>
+      attribute with every single code sample, especially if you are just referring
       a single code token within your paragraphs. So you don't have to do that.
       If you omit the <code lang="none">lang</code> attribute, then our site's
-      software will automatically use the language defined by your with one of
-      the previous code blocks.
+      software will automatically use the language defined by you with one of
+      the previous code blocks. You may also disable automatic syntax highlighting
+      with <code lang="html">&lt;code lang="none"&gt;</code>, which will cause
+      that code block to appear simply in monochrome color.
     </p>
     <p>
       Like with images, you can