Index: openacs-4/packages/acs-core-docs/www/xml/developers-guide/tutorial-debug.xml
===================================================================
RCS file: /usr/local/cvsroot/openacs-4/packages/acs-core-docs/www/xml/developers-guide/tutorial-debug.xml,v
diff -u -N -r1.4 -r1.5
--- openacs-4/packages/acs-core-docs/www/xml/developers-guide/tutorial-debug.xml	14 Oct 2003 10:03:22 -0000	1.4
+++ openacs-4/packages/acs-core-docs/www/xml/developers-guide/tutorial-debug.xml	11 Dec 2003 21:39:48 -0000	1.5
@@ -11,7 +11,7 @@
   </important>
 
   <authorblurb>
-    by <ulink url="mailto:joel@aufrecht.org">Joel Aufrecht</ulink>
+    <para>by <ulink url="mailto:joel@aufrecht.org">Joel Aufrecht</ulink></para>
   </authorblurb>
   
   <sect2><title>Debugging</title>
@@ -42,7 +42,7 @@
       <para>NOTE: explain how to add tcl to directly write your own
       log output</para>
     </formalpara>
-    <para>To set up real-time monitoring of the Aolserver error
+    <para>To set up real-time monitoring of the AOLserver error
           log, <emphasis role="bold">type</emphasis> <screen>less /usr/local/aolserver/log/openacs-dev-error.log</screen>
           <literallayout>F to show new log entries in real time (like tail -f)
 C-c to stop and F to start it up again. 
@@ -81,13 +81,15 @@
   </sect2>
   
   <sect2>
+    <title>Write automated tests</title>
+
     <authorblurb>
-      by <ulink url="mailto:simon@collaboraid.net">Simon Carstensen</ulink>
+      <para>by <ulink url="mailto:simon@collaboraid.net">Simon Carstensen</ulink></para>
     </authorblurb>
-    <title>Write automated tests</title>
-    <para><indexterm>
-        <primary>Create the automated tests for the package.</primary>
-      </indexterm>It seems to me that a lot of
+
+    <para>
+      <indexterm><primary>Automated tests</primary></indexterm>
+It seems to me that a lot of
 people have been asking for some guidelines on how to write automated
 tests. I've done several tests by now and have found the process to be
 extremely easy and useful. It's a joy to work with automated testing
@@ -200,7 +202,7 @@
 </screen>
         <para>There a number of other useful procs and I will encourage you to
 look at the few packages for which tests have already been implemented.
-That is perhaps the best documentation we have so far.</para>
+That is perhaps the best documentation we have so far.  See also <xref linkend="automated-testing-best-practices"/>.</para>
       </listitem>
     </orderedlist>