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>
