tomcat-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From ma...@apache.org
Subject svn commit: r279657 - in /tomcat/site/trunk: docs/findhelp.html docs/whichversion.html xdocs/findhelp.xml xdocs/whichversion.xml
Date Thu, 08 Sep 2005 22:13:50 GMT
Author: markt
Date: Thu Sep  8 15:13:43 2005
New Revision: 279657

URL: http://svn.apache.org/viewcvs?rev=279657&view=rev
Log:
Fill in some of the blanks

Modified:
    tomcat/site/trunk/docs/findhelp.html
    tomcat/site/trunk/docs/whichversion.html
    tomcat/site/trunk/xdocs/findhelp.xml
    tomcat/site/trunk/xdocs/whichversion.xml

Modified: tomcat/site/trunk/docs/findhelp.html
URL: http://svn.apache.org/viewcvs/tomcat/site/trunk/docs/findhelp.html?rev=279657&r1=279656&r2=279657&view=diff
==============================================================================
--- tomcat/site/trunk/docs/findhelp.html (original)
+++ tomcat/site/trunk/docs/findhelp.html Thu Sep  8 15:13:43 2005
@@ -76,7 +76,7 @@
 <a href="./faq/">FAQ</a>
 </li>
 <li>
-<a href="./mail.html">Mailing Lists</a>
+<a href="./lists.html#tomcat-user">Mailing Lists</a>
 </li>
 <li>
 <a href="./bugreport.html">Bug Database</a>
@@ -143,8 +143,8 @@
 <tr>
 <td bgcolor="#525D76">
 <font face="arial,helvetica,sanserif" color="#ffffff">
-<a name="TODO">
-<strong>TODO</strong>
+<a name="Find help">
+<strong>Find help</strong>
 </a>
 </font>
 </td>
@@ -153,8 +153,52 @@
 <td>
 <p>
 <blockquote>
-<p>Summary of ways to get help. What each one is, how and when it should
-be used etc.</p>
+
+<p>Apache Tomcat support is provided by the community, for the community, on a
+purely volunteer basis. This page has been written to help you find the help you
+need whilst making the most efficient use of the resources available. The types
+of help are presented in the same order they are typically used.</p>
+
+<p>The first resource to check is the documentation. As well as the Tomcat
+documentation (make sure you check the documentation for the version you are
+using) you should also check the relevant Servlet and/or JSP version. Much of
+Tomcat's behaviour is determined by these specifcations and the information in
+them is not typically duplciated in the Tomcat documentation.</p>
+
+<p>The logs which Apache Tomcat generates can be a valuable resource when trying
+to diagnose a problem. Please review them. You may want to enable debug output
+in your Apache Tomcat configuration so that you have more information to help
+diagnose the problem.</p>
+
+<p>It is unusual to find a problem that no-one else has seen. The chances are
+that your question has been asked and answered by somebody else. Use your
+favourite search engine to try and find it.</p>
+
+<p>Answers to very common questions are documented on the
+<a href="/faq/">FAQ</a>
+</p>.
+
+<p>The archives for the user mailing list are a rich source of useful
+information. Use the search features provided by one of them. A
+<a href="list.html">selection of archives</a> is provided on the mailing list
+page.</p>
+
+<p>If you have already subscribed to the
+<a href="mailto:tomcat-user@jakarta.apache.org">tomcat-user</a> or
+<a href="mailto:tomcat-dev@jakarta.apache.org">tomcat-dev</a> discussion lists
+you can ask about the problem on those lists. If you are not subscribed, you
+will need to subscribe before you can send your question to either of these
+lists. The <a href="list.html">mailing list</a> pages provide further
+information on how to use the mailing lists as well as subscription
+instructions.</p>
+
+<p>If you think you have found a bug, please following the 
+<a href="bugreporting.html">bug reporting</a> steps. Particularly if you are
+using an older version of Apache Tomcat, there is a good chance that the
+problem has been fixed so it is always worth searching the bug database to
+see if ths is the case.</p>
+
+<p>There is also an <a href="irc.html">IRC channel</a> dedicated to Tomcat.</p>
 
 </blockquote>
 </p>

Modified: tomcat/site/trunk/docs/whichversion.html
URL: http://svn.apache.org/viewcvs/tomcat/site/trunk/docs/whichversion.html?rev=279657&r1=279656&r2=279657&view=diff
==============================================================================
--- tomcat/site/trunk/docs/whichversion.html (original)
+++ tomcat/site/trunk/docs/whichversion.html Thu Sep  8 15:13:43 2005
@@ -80,7 +80,7 @@
 <a href="./faq/">FAQ</a>
 </li>
 <li>
-<a href="./mail.html">Mailing Lists</a>
+<a href="./lists.html#tomcat-user">Mailing Lists</a>
 </li>
 <li>
 <a href="./bugreport.html">Bug Database</a>
@@ -217,6 +217,53 @@
 community-driven support approach, the older your version the less people would
 be interested or able to support you.
 </p>
+
+</blockquote>
+</p>
+</td>
+</tr>
+<tr>
+<td>
+<br />
+</td>
+</tr>
+</table>
+<table width="100%" cellpadding="2" cellspacing="0" border="0">
+<tr>
+<td bgcolor="#525D76">
+<font face="arial,helvetica,sanserif" color="#ffffff">
+<a name="Alpha / Beta / Stable">
+<strong>Alpha / Beta / Stable</strong>
+</a>
+</font>
+</td>
+</tr>
+<tr>
+<td>
+<p>
+<blockquote>
+
+<p>Every Tomcat release is initially released as an Alpha release. After a week or
+so of testing a vote is held to gather views on the stability of the release. If a
+major issue is identified during testing, then the vote may not take place and the
+release will remain as an Alpha release.</p>
+
+<p>Stability is a subjective judgement and you should always read carefully the
+release notes for any version you intend to make use of.</p>
+
+<p>
+<strong>Alpha</strong> releases may contain large amounts of untested/missing
+functionality required by the specification and/or signifcant bugs and are not
+expected to run stably for any length of time.</p>
+
+<p>
+<strong>Beta</strong> releases may contain some untested functionlaity and/or
a
+number of relatively minor bugs. Beta releases are not expected to run stably.</p>
+
+<p>
+<strong>Stable</strong> releases may contain a small number of relatively minor
+bugs. Stable releases are intended for production use and are expected to run
+stably for extended periods of time.</p>
 
 </blockquote>
 </p>

Modified: tomcat/site/trunk/xdocs/findhelp.xml
URL: http://svn.apache.org/viewcvs/tomcat/site/trunk/xdocs/findhelp.xml?rev=279657&r1=279656&r2=279657&view=diff
==============================================================================
--- tomcat/site/trunk/xdocs/findhelp.xml (original)
+++ tomcat/site/trunk/xdocs/findhelp.xml Thu Sep  8 15:13:43 2005
@@ -7,9 +7,52 @@
 
 <body>
 
-<section name="TODO">
-<p>Summary of ways to get help. What each one is, how and when it should
-be used etc.</p>
+<section name="Find help">
+
+<p>Apache Tomcat support is provided by the community, for the community, on a
+purely volunteer basis. This page has been written to help you find the help you
+need whilst making the most efficient use of the resources available. The types
+of help are presented in the same order they are typically used.</p>
+
+<p>The first resource to check is the documentation. As well as the Tomcat
+documentation (make sure you check the documentation for the version you are
+using) you should also check the relevant Servlet and/or JSP version. Much of
+Tomcat's behaviour is determined by these specifcations and the information in
+them is not typically duplciated in the Tomcat documentation.</p>
+
+<p>The logs which Apache Tomcat generates can be a valuable resource when trying
+to diagnose a problem. Please review them. You may want to enable debug output
+in your Apache Tomcat configuration so that you have more information to help
+diagnose the problem.</p>
+
+<p>It is unusual to find a problem that no-one else has seen. The chances are
+that your question has been asked and answered by somebody else. Use your
+favourite search engine to try and find it.</p>
+
+<p>Answers to very common questions are documented on the
+<a href="/faq/">FAQ</a></p>.
+
+<p>The archives for the user mailing list are a rich source of useful
+information. Use the search features provided by one of them. A
+<a href="list.html">selection of archives</a> is provided on the mailing list
+page.</p>
+
+<p>If you have already subscribed to the
+<a href="mailto:tomcat-user@jakarta.apache.org">tomcat-user</a> or
+<a href="mailto:tomcat-dev@jakarta.apache.org">tomcat-dev</a> discussion lists
+you can ask about the problem on those lists. If you are not subscribed, you
+will need to subscribe before you can send your question to either of these
+lists. The <a href="list.html">mailing list</a> pages provide further
+information on how to use the mailing lists as well as subscription
+instructions.</p>
+
+<p>If you think you have found a bug, please following the 
+<a href="bugreporting.html">bug reporting</a> steps. Particularly if you are
+using an older version of Apache Tomcat, there is a good chance that the
+problem has been fixed so it is always worth searching the bug database to
+see if ths is the case.</p>
+
+<p>There is also an <a href="irc.html">IRC channel</a> dedicated to Tomcat.</p>
 
 </section>
 

Modified: tomcat/site/trunk/xdocs/whichversion.xml
URL: http://svn.apache.org/viewcvs/tomcat/site/trunk/xdocs/whichversion.xml?rev=279657&r1=279656&r2=279657&view=diff
==============================================================================
--- tomcat/site/trunk/xdocs/whichversion.xml (original)
+++ tomcat/site/trunk/xdocs/whichversion.xml Thu Sep  8 15:13:43 2005
@@ -53,6 +53,29 @@
 
 </section>
 
+<section name="Alpha / Beta / Stable">
+
+<p>Every Tomcat release is initially released as an Alpha release. After a week or
+so of testing a vote is held to gather views on the stability of the release. If a
+major issue is identified during testing, then the vote may not take place and the
+release will remain as an Alpha release.</p>
+
+<p>Stability is a subjective judgement and you should always read carefully the
+release notes for any version you intend to make use of.</p>
+
+<p><strong>Alpha</strong> releases may contain large amounts of untested/missing
+functionality required by the specification and/or signifcant bugs and are not
+expected to run stably for any length of time.</p>
+
+<p><strong>Beta</strong> releases may contain some untested functionlaity
and/or a
+number of relatively minor bugs. Beta releases are not expected to run stably.</p>
+
+<p><strong>Stable</strong> releases may contain a small number of relatively
minor
+bugs. Stable releases are intended for production use and are expected to run
+stably for extended periods of time.</p>
+
+</section>
+
 <section name="Apache Tomcat 5.x">
 
 <p><strong>Apache Tomcat 5.5.x</strong>.  Apache Tomcat 5.5 is the current
focus of



---------------------------------------------------------------------
To unsubscribe, e-mail: tomcat-dev-unsubscribe@jakarta.apache.org
For additional commands, e-mail: tomcat-dev-help@jakarta.apache.org


Mime
View raw message