diff --git a/docs/en/designers/language-modifiers/language-modifier-nl2br.xml b/docs/en/designers/language-modifiers/language-modifier-nl2br.xml
index 73a38124..30def339 100644
--- a/docs/en/designers/language-modifiers/language-modifier-nl2br.xml
+++ b/docs/en/designers/language-modifiers/language-modifier-nl2br.xml
@@ -21,7 +21,7 @@ $smarty->assign('articleTitle',
 ]]>
    </programlisting>
    <para>
-    Where template is:
+    Where the template is:
    </para>
    <programlisting>
 <![CDATA[
@@ -29,7 +29,7 @@ $smarty->assign('articleTitle',
 ]]>
    </programlisting>
    <para>
-    This should output:
+    will output:
    </para>
    <screen>
 <![CDATA[
diff --git a/docs/en/designers/language-variables/language-variables-smarty.xml b/docs/en/designers/language-variables/language-variables-smarty.xml
index f1b65339..c91b06c9 100644
--- a/docs/en/designers/language-variables/language-variables-smarty.xml
+++ b/docs/en/designers/language-variables/language-variables-smarty.xml
@@ -88,11 +88,13 @@
    <title>using {$smarty.const} to access constants</title>
 <programlisting role="php">
 <![CDATA[
+// the constant defined in php
 define('_MY_CONST_VAL','CHERRIES');
 ]]>
 </programlisting>
 <programlisting>
 <![CDATA[
+{* the output of php constant in the template *}
 {$smarty.const._MY_CONST_VAL}
 ]]>
 </programlisting>