--- 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{}.\index{comment markers}
+parsing. Problems are coded in xml. Comments in xml are of the format \texttt{}.
+\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.