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: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]