struts-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From hus...@apache.org
Subject svn commit: r505162 - in /struts/site/src/site: fml/kickstart.fml xdoc/downloads.xml
Date Fri, 09 Feb 2007 03:54:48 GMT
Author: husted
Date: Thu Feb  8 19:54:48 2007
New Revision: 505162

URL: http://svn.apache.org/viewvc?view=rev&rev=505162
Log:
SITE-19 Add "release" FAQ to kickstart and link from Releases page.

Modified:
    struts/site/src/site/fml/kickstart.fml
    struts/site/src/site/xdoc/downloads.xml

Modified: struts/site/src/site/fml/kickstart.fml
URL: http://svn.apache.org/viewvc/struts/site/src/site/fml/kickstart.fml?view=diff&rev=505162&r1=505161&r2=505162
==============================================================================
--- struts/site/src/site/fml/kickstart.fml (original)
+++ struts/site/src/site/fml/kickstart.fml Thu Feb  8 19:54:48 2007
@@ -43,7 +43,6 @@
             Documentation for past  <a href="downloads.html">releases</a>
                 is also available.
             </p>
-            
             <p>
             To learn more about using Apache Struts, you can also visit
             <a href="http://www.StrutsCentral.net/">Struts Central</a>,
@@ -59,7 +58,46 @@
             (Plain old Google usually works too!)</p>
             </answer>
         </faq>
-
+        <faq id="releases">
+           <question>
+            Looking at the releases page, some versions seem to be missing. 
+            What happened to them?
+           </question>
+           <answer>
+           <p>
+            Apache Struts uses a "milestone build" system. 
+            First, we create a build with a milestone version number, 
+            like Struts 2.0.42, and post the distribution in the development area. 
+            The development group tests the distribution, 
+            and then we decide whether or not to release it. 
+            The distribution includes everything that would be released, 
+            including the documentation and the release notes for this version.
+           </p><p>
+            If we find a significant problem with the distribution, 
+            we may decide not to release it, 
+            and just leave the distribution as a "test build". 
+            The testing may take several days, and in the meantime, 
+            we want to keep the project moving, 
+            and so we just go onto the next version number.
+            Using our example, the next distribution would be labeled 
+            2.0.43, even if version 2.0.42 was never officially released. 
+           </p><p>            
+            Often. we will first grade a release as a "beta", 
+            and invite other users to test it too. 
+            If this second round of beta testing goes well, 
+            then we can mark the release "General Availability". 
+            Usually, that designation would also make it the new 
+            "Best Available" release.
+            In this case, we don't create another distribution, 
+            but simply adjust the status of the same set of bits 
+            that people have been testing all along.
+           </p><p>
+            In practice, this approach is fast and efficient 
+            and creates the fewest number of "candidate builds" 
+            between releases. 
+           </p>
+          </answer>    
+        </faq>
         <faq id="struts">
             <question>Why is the project called "Struts"?</question>
             <answer>

Modified: struts/site/src/site/xdoc/downloads.xml
URL: http://svn.apache.org/viewvc/struts/site/src/site/xdoc/downloads.xml?view=diff&rev=505162&r1=505161&r2=505162
==============================================================================
--- struts/site/src/site/xdoc/downloads.xml (original)
+++ struts/site/src/site/xdoc/downloads.xml Thu Feb  8 19:54:48 2007
@@ -26,10 +26,10 @@
         <section name="Apache Struts Releases">
 
             <p>
-                Releases of the Apache Struts framework 
+                Releases of the Apache Struts framework
                 are made available to the general public at no charge,
                 under the
-                <a href="http://apache.org/licenses/">Apache License,</a>   
            
+                <a href="http://apache.org/licenses/">Apache License,</a>
                 in both binary and source distributions.
                 Individual JARs are also made available through
                 <a href="http://maven.apache.org">Apache Maven</a>
@@ -85,21 +85,25 @@
             <p>
                 Project releases are approved by vote of the
                 Apache Struts  <a href="bylaws.html">Project Management Committee.</a>
-                Support for a release is provided by 
-                <a href="dev/volunteers.html">project volunteers</a> 
+                Support for a release is provided by
+                <a href="dev/volunteers.html">project volunteers</a>
                 on the <a href="mail.html">User mailing list.</a>
-                Additional free support is provided by many other 
-                volunteer subscribers to the list. 
-                Issues with a release may be discussed on the list 
-                and reported through the 
+                Additional free support is provided by many other
+                volunteer subscribers to the list.
+                Issues with a release may be discussed on the list
+                and reported through the
                 <a href="http://issues.apache.org/struts/">issue tracker.</a>
             </p>
-            
+
             <p>
-                The user mailing list and issue tracker are the <strong>only</strong>

-                support options hosted by the Apache Struts project. 
+                The user mailing list and issue tracker are the <strong>only</strong>
+                support options hosted by the Apache Struts project.
             </p>
-            
+
+            <p>
+                <a href="kickstart.html#releases"><strong>Why are some version
numbers missing?</strong></a>
+            </p>
+
             </section>
 
         <a name="PriorReleases"/>
@@ -109,7 +113,7 @@
                 As a couresty, we retain archival copies of the website for each "General
Availablity" release.
                 Product support for older releases may be limited.
             </p>
-            
+
             <ul>
                 <li>
                     <a href="http://struts.apache.org/1.3.5/index.html">Struts 1.3.5</a>
@@ -133,33 +137,33 @@
                     <a href="http://struts.apache.org/1.0.2/index.html">Struts 1.0.2</a>
                 </li>
             </ul>
-            
+
             <p>
                 The documentation is bundled with each <a href="http://archive.apache.org/dist/struts/">
-                distribution.</a> We <strong>strongly recommend</strong>
installing the documentation 
+                distribution.</a> We <strong>strongly recommend</strong>
installing the documentation
                 for a release locally, so as to conserve bandwidth.
             </p>
 
         </section>
 
             <section name="Licensing of Apache Struts Releases">
-                <p>        
-                    Apache Struts 2 source code and documentation is 
+                <p>
+                    Apache Struts 2 source code and documentation is
                     licensed to the Apache Software Foundation (ASF) under one
                     or more contributor license agreements. See the NOTICE file
                     included in any distribution for additional information
-                    regarding copyright ownership. The ASF licenses the source 
-                    code and documentation files in our Apache Struts distribution 
-                    to you under the Apache License, Version 2.0 (the "License"); 
+                    regarding copyright ownership. The ASF licenses the source
+                    code and documentation files in our Apache Struts distribution
+                    to you under the Apache License, Version 2.0 (the "License");
                     you may not use the Apache Struts product except in compliance
-                    with the License. 
+                    with the License.
                 </p>
 
                 <p>
                     You may obtain a copy of the License at
                     <a href="http://www.apache.org/licenses/LICENSE-2.0">
                     http://www.apache.org/licenses/LICENSE-2.0</a>.
-                </p> 
+                </p>
 
                 <p>
                     Unless required by applicable law or agreed to in writing,
@@ -167,8 +171,8 @@
                     "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
                     KIND, either express or implied.  See the License for the
                     specific language governing permissions and limitations
-                    under the License.  
-                </p> 
+                    under the License.
+                </p>
         </section>
 
         <section>



Mime
View raw message