--- 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/22 19:32:44	1.8
@@ -7,7 +7,7 @@ The one exception to this is where your
 case you may be able to carry out standard file operations (copy, move, add file etc.) using your computer's 
 standard filesystem interface, after you have established access to your authoring space volume.
 
-LON-CAPA has three work spaces: the ROLES menu, the course/community space where courses are developed from resources, and the authoring space where resources are composed and published. There are two user manuals for LON-CAPA, a course coordinator manual and author manual. Also, quick reference guides are available for both manuals at \texttt{http://help.loncapa.org}. This is the author manual used to create resources such as problems that can later be added to your course.
+LON-CAPA has three work spaces: the ROLES menu, the course/community space where courses are developed from resources, and the authoring space where resources are composed and published. There are two user manuals for LON-CAPA, a course coordinator manual and author manual. Also, there are quick reference guides to building a course and building an exam,  available at \texttt{http://help.loncapa.org}. This is the author manual used to create resources such as problems that can later be added to your course.
 
 Before creating problems, you should have:
 
@@ -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 your 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.
+