--- loncom/html/adm/help/tex/Author_LON-CAPA_Introduction.tex	2013/08/05 00:36:18	1.5
+++ loncom/html/adm/help/tex/Author_LON-CAPA_Introduction.tex	2013/08/18 01:37:44	1.7
@@ -51,3 +51,13 @@ The power of LON-CAPA for problem random
 
 Two computer algebra systems are interfaced to LON-CAPA, Maxima and R. This provides for algebra and calculus problems and responses. The R system has strong capabilities for statistics. Special script functions are provided to call Maxima and R to generate correct responses for a randomized problem, and also to check student responses.
 
+\textbf{Comments}
+
+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}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.
+