doc and testing guidelines should be part of the developers manual.
authorswa <swa@users.sourceforge.net>
Mon, 10 Sep 2001 17:06:41 +0000 (17:06 +0000)
committerswa <swa@users.sourceforge.net>
Mon, 10 Sep 2001 17:06:41 +0000 (17:06 +0000)
doc/webserver/developer-manual.html
doc/webserver/documentation-guidelines.html [deleted file]
doc/webserver/testplan.html [deleted file]

index 2a74cd1..ef770c1 100644 (file)
@@ -6,7 +6,7 @@
                 This file belongs into
                 ijbswa.sourceforge.net:/home/groups/i/ij/ijbswa/htdocs/
                 
- $Id: developer-manual.html,v 1.1 2001/06/13 14:20:37 swa Exp $
+ $Id: developer-manual.html,v 1.2 2001/06/13 14:28:31 swa Exp $
 
  Written by and Copyright (C) 2001 the SourceForge
  IJBSWA team.  http://ijbswa.sourceforge.net
 <body>
 <p>
 <br><br>
-<h1>How to quickly dive into Junkbuster Development:</h1>
+<h1>Junkbuster Developer Manual</h1>
+<h2>Table of Contents</h2>
+<p>
+<ol>
+  <li>Quickstart to Junkbuster Development
+  <li>Documentation Guidelines
+  <li>Coding Guidelines
+  <li>Testing Guidelines
+</ol>
+
+<h2>Quickstart to Junkbuster Development</h2>
+<p>To be filled.
+<h3>Introduction</h3>
+<p>To be filled.
+<h3>Read the developers manual</h3>
+<p>To be filled.
+<h3>Getting an account on sourceforge.net</h3>
+<p>To be filled.
+<h3>Subscribe to the developer's mailing list</h3>
+<p>To be filled.
+<h3>Downloading the sources</h3>
+<p>To be filled.
+<h2>Documentation Guidelines</h2>
+<p>
+All docs should be ...
+<ul>
+  <li>in a format that is widely used. I propose HTML.
+  <li>we either
+      <ul>
+       <li>generate man pages from the documentation (let's _NOT_ write them manually), or 
+       <li>we have a man page that points to the documentation (I propose
+           this option)
+      </ul>
+  <li>have a consistent layout
+  <li>have a link to the latest version of the document (i.e. point to a URL at sf)
+  <li>be consistent with the redirect script (i.e. the junkbuster program
+      points via the redirect URL at sf to valid end-points in the document)
+  <li>started from scratch but recycle parts from the original junkbuster documents
+</ul>
+
+<h2>Coding Guidelines</h2>
+<p>To be filled.
+<p>
+
+<h2>Testing Guidelines</h2>
+<h3>Testplan for releases:</h3>
+<p>
+<ol>
+  <li>Remove any existing rpm with rpm -e
+  <li>Remove any file that was left over. This includes (but is not limited
+      to)
+      <ul>
+       <li>/var/log/junkbuster
+       <li>/etc/junkbuster
+       <li>/usr/sbin/junkbuster
+       <li>/etc/init.d/junkbuster
+       <li>/usr/doc/junkbuster*
+      </ul>
+  <li>Install the rpm. Any error messages?
+  <li>start,stop,status junkbuster with the specific script
+      (e.g. /etc/rc.d/init/junkbuster stop). Reboot your machine. Does
+      autostart work?
+  <li>Start browsing. Does the junkbuster work? Logfile written?
+  <li>Remove the rpm. Any error messages? All files removed?
+</ol>
+
+<h3>Test reports:</h3>
+<p>
+Please submit test reports only with the <a href="http://sourceforge.net/tracker/?func=add&group_id=11118&atid=395005">test form</a>
+at sourceforge. Three simple steps:
+<ul>
+  <li>Select category: the distribution you test on.
+  <li>Select group: the version of Junkbuster that we are about to release.
+  <li>Fill the Summary and Detailed Description with something intelligent
+      (keep it short and precise).
+</ul>
+<p>
+Do not mail to the mailinglist (we cannot keep track on issues there).
+
 <p>
 
 <br>
 <hr>
 <p><address><a href=mailto:ijbswa-developers@lists.sourceforge.net>the developers</a></address><p>
 <!-- hhmts start -->
-Last modified: Wed Jun 13 16:26:49 CEST 2001
+Last modified: Mon Sep 10 19:03:17 CEST 2001
 <!-- hhmts end -->
 </body>
  <!--
@@ -64,6 +142,9 @@ Last modified: Wed Jun 13 16:26:49 CEST 2001
  Temple Place - Suite 330, Boston, MA  02111-1307, USA.
 
 $Log: developer-manual.html,v $
+Revision 1.2  2001/06/13 14:28:31  swa
+docs should have an author.
+
 Revision 1.1  2001/06/13 14:20:37  swa
 first import of project's documentation for the webserver.
 
diff --git a/doc/webserver/documentation-guidelines.html b/doc/webserver/documentation-guidelines.html
deleted file mode 100644 (file)
index f6a23fe..0000000
+++ /dev/null
@@ -1,86 +0,0 @@
-<!DOCTYPE HTML PUBLIC "-//IETF//DTD HTML//EN">
-<!--
- File        :  $Source: /cvsroot/ijbswa/current/doc/webserver/documentation-guidelines.html,v $
-
- Purpose     :  Gives direction on writing documentation.
-                This file belongs into
-                ijbswa.sourceforge.net:/home/groups/i/ij/ijbswa/htdocs/
-                
- $Id: documentation-guidelines.html,v 1.1 2001/06/13 14:20:37 swa Exp $
-
- Written by and Copyright (C) 2001 the SourceForge
- IJBSWA team.  http://ijbswa.sourceforge.net
-
- Based on the Internet Junkbuster originally written
- by and Copyright (C) 1997 Anonymous Coders and 
- Junkbusters Corporation.  http://www.junkbusters.com
--->
-
-<head>
-<title>Junkbuster|Documentation Guidelines</title>
-<link rel=stylesheet type="text/css" href="swa.css">
-
-</head>
- <body bgcolor="#ffffff"
- topmargin="0" leftmargin="0" marginwidth = "0" marginheight = "0" 
- text="#000000" 
- link="#0000ff" 
- vlink="#ff0000" 
- alink="#ff0000"
- >
-
-<body>
-<p>
-<br><br>
-<h1>Documentation guideline:</h1>
-<p>
-All docs should be ...
-<ul>
-  <li>in a format that is widely used. I propose HTML.
-  <li>we either
-      <ul>
-       <li>generate man pages from the documentation (let's _NOT_ write them manually), or 
-       <li>we have a man page that points to the documentation (I propose
-           this option)
-      </ul>
-  <li>have a consistent layout
-  <li>have a link to the latest version of the document (i.e. point to a URL at sf)
-  <li>be consistent with the redirect script (i.e. the junkbuster program
-      points via the redirect URL at sf to valid end-points in the document)
-  <li>started from scratch but recycle parts from the original junkbuster documents
-</ul>
-
-<br>
-
-<hr>
-<p><address><a href=mailto:ijbswa-developers@lists.sourceforge.net>the developers</a></address><p>
-<!-- hhmts start -->
-Last modified: Wed Jun 13 16:26:48 CEST 2001
-<!-- hhmts end -->
-</body>
- <!--
- This program is free software; you can redistribute it 
- and/or modify it under the terms of the GNU General
- Public License as published by the Free Software
- Foundation; either version 2 of the License, or (at
- your option) any later version.
-
- This program is distributed in the hope that it will
- be useful, but WITHOUT ANY WARRANTY; without even the
- implied warranty of MERCHANTABILITY or FITNESS FOR A
- PARTICULAR PURPOSE.  See the GNU General Public
- License for more details.
-
- The GNU General Public License should be included with
- this file.  If not, you can view it at
- http://www.gnu.org/copyleft/gpl.html
- or write to the Free Software Foundation, Inc., 59
- Temple Place - Suite 330, Boston, MA  02111-1307, USA.
-
-$Log: documentation-guidelines.html,v $
-Revision 1.1  2001/06/13 14:20:37  swa
-first import of project's documentation for the webserver.
-
--->
-</html>
diff --git a/doc/webserver/testplan.html b/doc/webserver/testplan.html
deleted file mode 100644 (file)
index 050a66d..0000000
+++ /dev/null
@@ -1,102 +0,0 @@
-<!DOCTYPE HTML PUBLIC "-//IETF//DTD HTML//EN">
-<!--
- File        :  $Source: /cvsroot/ijbswa/current/doc/webserver/testplan.html,v $
-
- Purpose     :  Provide guideance to test before release
-                This file belongs into
-                ijbswa.sourceforge.net:/home/groups/i/ij/ijbswa/htdocs/
-                
- $Id: testplan.html,v 1.1 2001/06/13 14:20:37 swa Exp $
-
- Written by and Copyright (C) 2001 the SourceForge
- IJBSWA team.  http://ijbswa.sourceforge.net
-
- Based on the Internet Junkbuster originally written
- by and Copyright (C) 1997 Anonymous Coders and 
- Junkbusters Corporation.  http://www.junkbusters.com
--->
-
-<head>
-<title>Junkbuster|Testplan</title>
-<link rel=stylesheet type="text/css" href="swa.css">
-
-</head>
- <body bgcolor="#ffffff"
- topmargin="0" leftmargin="0" marginwidth = "0" marginheight = "0" 
- text="#000000" 
- link="#0000ff" 
- vlink="#ff0000" 
- alink="#ff0000"
- >
-
-<body>
-<p>
-<br><br>
-<h1>Testplan for releases:</h1>
-<p>
-<ol>
-  <li>Remove any existing rpm with rpm -e
-  <li>Remove any file that was left over. This includes (but is not limited
-      to)
-      <ul>
-       <li>/var/log/junkbuster
-       <li>/etc/junkbuster
-       <li>/usr/sbin/junkbuster
-       <li>/etc/init.d/junkbuster
-       <li>/usr/doc/junkbuster*
-      </ul>
-  <li>Install the rpm. Any error messages?
-  <li>start,stop,status junkbuster with the specific script
-      (e.g. /etc/rc.d/init/junkbuster stop). Reboot your machine. Does
-      autostart work?
-  <li>Start browsing. Does the junkbuster work? Logfile written?
-  <li>Remove the rpm. Any error messages? All files removed?
-</ol>
-
-<h1>Test reports:</h1>
-<p>
-Please submit test reports only with the <a href="http://sourceforge.net/tracker/?func=add&group_id=11118&atid=395005">test form</a>
-at sourceforge. Three simple steps:
-<ul>
-  <li>Select category: the distribution you test on.
-  <li>Select group: the version of Junkbuster that we are about to release.
-  <li>Fill the Summary and Detailed Description with something intelligent
-      (keep it short and precise).
-</ul>
-<p>
-Do not mail to the mailinglist (we cannot keep track on issues there).
-
-<br>
-
-<hr>
-<p><address><a href=mailto:ijbswa-developers@lists.sourceforge.net>the developers</a></address><p>
-<!-- hhmts start -->
-Last modified: Wed Jun 13 16:26:44 CEST 2001
-<!-- hhmts end -->
-</body>
- <!--
- This program is free software; you can redistribute it 
- and/or modify it under the terms of the GNU General
- Public License as published by the Free Software
- Foundation; either version 2 of the License, or (at
- your option) any later version.
-
- This program is distributed in the hope that it will
- be useful, but WITHOUT ANY WARRANTY; without even the
- implied warranty of MERCHANTABILITY or FITNESS FOR A
- PARTICULAR PURPOSE.  See the GNU General Public
- License for more details.
-
- The GNU General Public License should be included with
- this file.  If not, you can view it at
- http://www.gnu.org/copyleft/gpl.html
- or write to the Free Software Foundation, Inc., 59
- Temple Place - Suite 330, Boston, MA  02111-1307, USA.
-
- $Log: testplan.html,v $
- Revision 1.1  2001/06/13 14:20:37  swa
- first import of project's documentation for the webserver.
-
--->
-</html>