--- loncom/html/adm/help/tex/Author_LON-CAPA_Introduction.tex	2013/08/14 03:33:06	1.6
+++ loncom/html/adm/help/tex/Author_LON-CAPA_Introduction.tex	2013/08/18 01:37:44	1.7
@@ -55,5 +55,9 @@ Two computer algebra systems are interfa
 
 Commenting you xml and scripts is important for both you and other users. Commenting within a loncapa/perl script 
 is denoted with a \#. This can be entered anwhere in a line and the remainder of the line will be ignored when
-parsing. Problems are coded in xml. Comments in xml are of the format \texttt{<!-- comment -->}.\index{comment markers}
+parsing. Problems are coded in xml. Comments in xml are of the format \texttt{<!-- comment -->}.
+\index{comment markers}However, it is important to know that the XML comments 
+propagate through to the rendered web page viewed by students while the perl comments 
+within the script are not. Hence, writing solution hints within XML comments is 
+discouraged for obvious reasons.