[LON-CAPA-cvs] cvs: loncom /html/adm/help/tex Additional_Help.tex Bugzilla.tex Help.tex

[lira]

lira		Sun Jul 14 02:39:24 2013 EDT

  Modified files:              
    /loncom/html/adm/help/tex	Additional_Help.tex Bugzilla.tex Help.tex 
  Log:
  improving help description
  
  
Index: loncom/html/adm/help/tex/Additional_Help.tex
diff -u loncom/html/adm/help/tex/Additional_Help.tex:1.7 loncom/html/adm/help/tex/Additional_Help.tex:1.8
--- loncom/html/adm/help/tex/Additional_Help.tex:1.7	Tue Jul 11 19:00:52 2006
+++ loncom/html/adm/help/tex/Additional_Help.tex	Sun Jul 14 02:39:24 2013
@@ -1,3 +1,10 @@
 \label{Additional_Help}
-You can find additional help about LON-CAPA and download copies of this manual at \underbar{http://help.lon-capa.org}. You can also access our FAQ-o-matic page and submit a ticket
-requesting additional help from a member of LON-CAPA's tech support staff.
+You can find additional help about LON-CAPA and download copies of this manual at 
+\texttt{http://help.lon-capa.org}. For additional help, use the \textbf{Help} link
+on the upper right of the screen to find a link to contact the helpdesk, or 
+search the loncapa listservs at \\
+\texttt{http://mail.lon-capa.org/mailman/swish.cgi}. You may wish to join the listserv
+loncapa-users at \texttt{http://mail.lon-capa.org}. \index{listserv}\index{LON-CAPA listserv}
+The family of users is very helpful
+in assisting users with questions posted to the listserv.
+
Index: loncom/html/adm/help/tex/Bugzilla.tex
diff -u loncom/html/adm/help/tex/Bugzilla.tex:1.9 loncom/html/adm/help/tex/Bugzilla.tex:1.10
--- loncom/html/adm/help/tex/Bugzilla.tex:1.9	Mon Aug 14 16:32:24 2006
+++ loncom/html/adm/help/tex/Bugzilla.tex	Sun Jul 14 02:39:24 2013
@@ -1,6 +1,28 @@
 \label{Bugzilla}
-LON-CAPA uses Bugzilla (\underbar{http://www.bugzilla.org/}) to report and track bugs 
-and enhancements.  You must have an account to use Bugzilla. You can create an account at \underbar{http://bugs.lon-capa.org} by clicking on the link \underbar{Open a New Bugzilla Account}. Once you have an open account, report a bug or request an enhancement by:
+\index{bugs}\index{Bugzilla}\index{suggestions}
+We Welcome Your Ideas and Contributions...
+
+LON-CAPA is open-source software where everyone is free to contribute to the 
+development. If you think of an enhancement, or find a bug in the system, 
+please report it. LON-CAPA uses Bugzilla (\underbar{http://www.bugzilla.org/}) 
+to report and track bugs and enhancement requests.  All reported bugs and enhancement 
+requests posted on Bugzilla are examined by the core LON-CAPA team. Having the 
+request in Bugzilla helps keep track of both bugs and requests, and is the preferred 
+method of reporting bugs and requesting enhancements. You'll be able to see how the developers respond to
+the bug, which developer is currently responsible for it, and what the developer's intention
+is.
+
+You must have an account to use Bugzilla. You can create an account at 
+\underbar{http://bugs.lon-capa.org} by clicking on the link \underbar{Open a New Bugzilla Account}. 
+Once you have an open account, please search existing cases for related content before
+submitting a new case. Selecting ``LON-CAPA" and ``LON-CAPA Redesign" in the ``Product" category 
+is a good idea for searching. Hold the 
+Cntrl key while cliking multiple items. The ``Component", ``Version", and ``Target" can be left
+undesignated. If you find a related bug, you can add comments instead of reporting a new bug. If
+you find a bug that you are interested in following, you can add your e-mail to the ``Add cc:" box
+and click ``Commit".
+
+You can report a bug or request an enhancement by:
 
 \begin{enumerate}
 
@@ -9,22 +31,12 @@
 \item Select the (LON-CAPA) product link.
 \item At the login screen, enter your email address and password.
 \item Click the {[}Login{]} button.
-\item Select the LON-CAPA Version, Component, Platform and Operating System.
-\item Enter a summary in the "Summary" text box.
-\item Enter a description in the "Description" text box.
+\item Select the LON-CAPA Version, Component, Platform and Operating System (as much as known).
+\item Enter a summary in the ``Summary" text box.
+\item Enter a description in the ``Description" text box.
 \item Click the {[}Commit{]} button.
 
 \end{enumerate}
 
-We Welcome Your Ideas and Contributions...
-
-LON-CAPA is open-source software where everyone is free to contribute to the 
-development. If you think of an enhancement, or find a bug in the system, 
-please report it. All reported bugs and enhancement requests posted on Bugzilla
-will be examined by the core LON-CAPA team. Having the request in Bugzilla helps keep track of both bugs and requests, and is the preferred method of reporting bugs and requesting enhancements.
-
-Bugzilla also supports ongoing conversation about requests and workflow and 
-accountability features. You'll be able to see how the developers respond to
-the bug, which developer is currently responsible for it, and what the developer's intention
-is.
+A developer will follow up with you.
 
Index: loncom/html/adm/help/tex/Help.tex
diff -u loncom/html/adm/help/tex/Help.tex:1.4 loncom/html/adm/help/tex/Help.tex:1.5
--- loncom/html/adm/help/tex/Help.tex:1.4	Mon Aug 14 16:32:24 2006
+++ loncom/html/adm/help/tex/Help.tex	Sun Jul 14 02:39:24 2013
@@ -1,4 +1,12 @@
 \label{Help}
-On many LON-CAPA pages, you will see small blue boxes with white 
-question marks inside. The blue boxes are links to relevant help documentation. 
+\index{help}\index{help icon}On many LON-CAPA pages, you will see small blue circle 
+\includegraphics[width=0.03\paperwidth]{help} with a white 
+question mark inside. The blue circles are links to relevant help documentation.
+
+Also, a \textbf{Help} link is available in the upper right. This help page
+provides links to the course manual (from within a course) or the author manual
+(from the authoring space) and provides both an online version and pdf version.
+You may wish to save a pdf version of each so that you can reference the help for one
+role while working in the other role. The help page also provides a link to 
+request help from the LON-CAPA help desk and a link to report bugs.