--- loncom/html/adm/help/tex/Bugzilla.tex	2006/08/14 16:32:24	1.9
+++ loncom/html/adm/help/tex/Bugzilla.tex	2016/08/20 16:06:50	1.15
@@ -1,30 +1,44 @@
 \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 (\texttt{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 feature 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 intentions
+are.
+
+You must have an account to use Bugzilla. You can create an account at\\
+\texttt{http://bugs.lon-capa.org} by clicking on the link \textbf{Open a New Bugzilla Account}. 
+You will be directed to send an e-mail to the LON-CAPA Helpdesk to request creation of a Bugzilla 
+account. 
+Once you have an open account, please search existing cases for related content before
+submitting a new case. Select ``LON-CAPA'' in the ``Product'' category when searching. 
+Hold the Ctrl key while clicking 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 as follows:
 
 \begin{enumerate}
 
-\item Open the web page \underbar{http://bugs.lon-capa.org}
-\item Click on the \underbar{Enter a new bug report} link.
+\item Open the web page \texttt{http://bugs.lon-capa.org}
+\item Click on the \textbf{Enter a new bug report} link.
 \item Select the (LON-CAPA) product link.
-\item At the login screen, enter your email address and password.
+\item At the login screen, enter your e-mail 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.