You are viewing a plain text version of this content. The canonical link for it is here.
Posted to dev@struts.apache.org by hu...@apache.org on 2003/07/04 19:37:33 UTC

cvs commit: jakarta-struts/doc volunteers.xml status.xml project.xml learning.xml index.xml acquiring.xml

husted      2003/07/04 10:37:33

  Modified:    doc      volunteers.xml status.xml project.xml learning.xml
                        index.xml acquiring.xml
  Log:
  Various changes to bring the site into the Struts 1.1++ era.
  
  Revision  Changes    Path
  1.25      +31 -16    jakarta-struts/doc/volunteers.xml
  
  Index: volunteers.xml
  ===================================================================
  RCS file: /home/cvs/jakarta-struts/doc/volunteers.xml,v
  retrieving revision 1.24
  retrieving revision 1.25
  diff -u -r1.24 -r1.25
  --- volunteers.xml	23 May 2003 04:18:40 -0000	1.24
  +++ volunteers.xml	4 Jul 2003 17:37:32 -0000	1.25
  @@ -9,27 +9,42 @@
   <body>
   <chapter name="Who We Are" href="whoWeAre">
   
  -<section name="The Meritocracy" href="meritocracy">
  +    <section name="Community Support" href="support">
   
  -    <p>
  -    All work Struts is contributed by volunteers whose only motivation is 
  -    to help make Struts work even better, both for themselves and for rest of 
  -    the community.
  -    </p>
  +        <p>
  +            As of June 25, 2003, there were 2744 subscribers to STRUTS-USER (plus an unknown
  +            number who read it through newsfeed mirrors).  It's the largest
  +            user mailing list at Jakarta, exceeding TOMCAT-USER that has ~2400.
  +        </p>
   
  -    <p>
  -    All contributions are welcome, and may discussed and posted the 
  -    mailing lists.
  -    The final decision of what becomes part of the official distribution is 
  -    made by a group of <a href="#committers">Committers</a>. 
  -    For more about Meritocracy, see the 
  -    <a href="http://jakarta.apache.org/site/roles.html">Management page</a> 
  -    the Apache Jakarta Website.
  -    </p>
  +        <p>
  +            Since Apache now uses a mirroring system, the precise number of downloads counts
  +            is unknown, but in the Summer of 2002, Struts was averaging
  +            8500 downloads per month. In liklihood, we well exceed that now.
  +        </p>
  +
  +        <p>
  +            Some high level traffic statistics for the Struts web site
  +            are
  +            <a href="http://www.apache.org/~vgritsenko/stats/index.html">
  +            now available.</a>
  +        </p>
   
  -</section>
  +        <p>
  +            There are a great number of third-party extensions are available for Struts,
  +            along with an equally vast number of articles and books.
  +            We try to list as many of these as we can in the
  +            <a href="resources/index.html">Resources area</a>.
  +        </p>
  +
  +    </section>
   
   <section name="Source Code Contributors" href="contributors.source">
  +
  +    <p>
  +        More than forty developers have contributed code or documentation to Struts.
  +        We've tried to list all of our volunteers on this page (and apologize to anyone we missed!).
  +    </p>
   
       <ul>
           <li>
  
  
  
  1.32      +60 -56    jakarta-struts/doc/status.xml
  
  Index: status.xml
  ===================================================================
  RCS file: /home/cvs/jakarta-struts/doc/status.xml,v
  retrieving revision 1.31
  retrieving revision 1.32
  diff -u -r1.31 -r1.32
  --- status.xml	7 Jun 2003 18:42:06 -0000	1.31
  +++ status.xml	4 Jul 2003 17:37:32 -0000	1.32
  @@ -53,59 +53,32 @@
   
       </section>
   
  -    <section href="struts_1_1" name="Struts 1.1">
  +<section href="struts_1_x" name="Struts 1.x">
   
       <p>
  -    Struts 1.1 provides a number of functional enhancements, including support
  -    for application modules.
  -    Other enhancements include action-based authentication, use of Commons-
  -    Datasource and Commons-Logging packages, declarative exception handling,
  -    Dynabean support, Plug-In classes, and a pluggable request processor.
  -    Several extensions are now bundled with the Struts distribution, including
  -    the Nested taglib, Tiles, and the Commons Validator.
  -    An optional Struts-el taglib makes it easy to use Struts with JSTL.
  -    Backward-compatiblity with Struts 1.0.x is a primary goal of this release.
  -    </p>
  -
  -    <p>
  -        <a href="proposals/release-plan-1.1rc1.html">Struts 1.1 Release Candidate 1</a>
  -        is in circulation and we are working toward a final release.
  -    </p>
  -</section>
  -
  -<section href="struts_1_2" name="Struts 1.2.x">
  -
  -    <p>
  -        Struts 1.2.x will include additional functional enhancements along the
  -        same lines as Struts 1.1.
  -        The platform requirements will remain the same (Servlet 2.2 / JSP 1.1).
  -        The release will focus on refactoring of existing functionality, with a
  -        continued emphasis on backward compatibility.
  -    </p>
  -
  -    <p>
  -        The Struts 1.2.x series is expected to incorporate several
  -        incremental releases (in contrast to Struts 1.1).
  +        The platform requirements throughout the Struts 1.x series will remain the same (Servlet 2.2 / JSP 1.1).
  +        The releases will focus on refactoring of existing functionality, with a
  +        continued emphasis on backward compatibility, as were seen in Struts 1.1.
  +        However, we expect there to releases to be incremental throughout the rest of the
  +        1.x series, so that improvements and fixes become available to production teams every few weeks.
       </p>
   
       <p>
           Enhancements are logged in Bugzilla as
           <a href="http://issues.apache.org/bugzilla/buglist.cgi?bug_status=RESOLVED&amp;resolution=LATER&amp;resolution=REMIND&amp;product=Struts&amp;order=%27Importance%27">
           LATER or REMIND tickets as they are suggested</a>.
  -        Enhancements that represent incremental improvements are now being
  -        tagged for the "Struts 1.2 family" milestone.
  -        When developers are actually working on an enhancement,
  -        they should re-tag it for a specific release milestone, such as "1.2.1" or "1.2.2".
           Future release milestones are provided for enhancements which are
           being actively planned or developed
           but may not be ready for the very next release.
  +        When developers are actually working on an enhancement,
  +        they should re-tag it for a specific release milestone, such as "1.2.1" or "1.2.2".
       </p>
   
       <p>
  -        The listing of an enhancement in Bugzilla does not imply that is being "planned",
  -        merely that it is under consideration.
  +        <b>The listing of an enhancement in Bugzilla does not imply that is being "planned"</b>,
  +        merely that someone has suggested it, and the idea hasn't been ruled out.
           If a listing has not been tagged for a specific milestone by a working developer,
  -        then it may never be realized.
  +        then <b>it may never be realized</b>.
       </p>
   
       <p>
  @@ -116,6 +89,27 @@
           please post a note on the ticket, and tag it to an appropriate release milestone.
       </p>
   
  +    <p>
  +        Any feature that can be implemented under Servlet 2.2/JSP 1.1 may be considered for the Struts 1.x series.
  +        This may include, but is not limited to, better support for alternate view technologies (like XLST),
  +        integrated unit testing, integrated support for HTTP/HTTPS mode switching, better workflow handling,
  +        support for alternative action types (e.g. BSF actions), and so forth.
  +    </p>
  +
  +    <p>
  +        Features most likely to be considered are those that have already been implemented as
  +        third-party extensions and are in active use by the Struts Community, such as
  +        those distributed through the
  +        <a href="http://sourceforge.net/projects/struts">Struts SourceForge</a> site.
  +    </p>
  +
  +    <p>
  +        Throughout the 1.x series, there will be a continued emphasis on expanding unit test coverage for the framework.
  +        Bug reports should include a failing test case when possible.
  +        Proposals for new features should include a working test suite.
  +        (Creating features through Test Driven Development is strongly encouraged.)
  +    </p>
  +
     <!--
       <p>
       Features under discussion include:
  @@ -181,10 +175,13 @@
   <section href="struts_2_0" name="Struts 2.0.x">
   
       <p>
  -    Struts 2.0.x will include broader enhancements.
  -    The implementation will expect a minimum platform of Servlet 2.3 / JSP 1.2 and
  -    refactorings may include the use of Filters.
  -    It is expected that Struts 2.0.x will rely on JSTL and the JavaServer Faces
  +    Struts 2.x (aka Struts "Next Generation") will include broader enhancements.
  +    We anticipate that the implementation will utilize the Servlet 2.4 / JSP 2.0
  +    platform. Refactorings may include the use of Filters and so forth.
  +    </p>
  +
  +    <p>
  +    We anticipate that Struts 2.x will rely on JSTL and the JavaServer Faces
       API as supporting technologies.
       However, the focus of the Struts framework will remain on the Controller aspect of a Model 2/MVC architecture.
       The core framework will continue to be both Model and View independent.
  @@ -197,34 +194,37 @@
       <ul>
   
           <li>
  -        Refactoring for Filters and other new technologies
  +        Comprehensive unit test coverage for all core features
           </li>
   
           <li>
  -        Direct support for JSTL/JSF taglibs and the JSF API
  +        Refactoring for Filters and other new technologies
           </li>
   
           <li>
  -        Better support for other presentation layers, such as XLST (as in
  -        1.2.x)
  +        Direct support for JSTL/JSF taglibs and the JSF API
           </li>
   
           <li>
  -        Comprehensive unit tests (as in 1.2.x)
  +        Enchanced support for other presentation layers, such as XLST
           </li>
   
       </ul>
   
       <p>
  -    Development of Struts 2.0 will include taking a completely fresh look at
  +    Development of Struts 2.x will include taking a completely fresh look at
       the architecture.
  -    The goal for 2.0 will be to incorporate everything we've learned in the past
  +    The goal for 2.x will be to incorporate everything we've learned in the past
       years of Struts usage, and create something even better.
       </p>
   
       <p>
  -    Of course, it is anticipated that the Struts team will continue to support
  -    1.x users for a long time with bugfixes and incremental enhancements.
  +        Of course, it is anticipated that the Struts team will continue to support
  +        the 1.x codebase for a long time with bugfixes and incremental enhancements.
  +        (Mainly because many of us will still be using it on our production sites!)
  +        Accordingly, it is anticipated that the development of the 2.x and 1.x
  +        series will occur in tandem.
  +        At some point, 2.x milestones may appear alongside new 1.x releases.
       </p>
   
   </section>
  @@ -234,7 +234,7 @@
       <ul>
   
           <li>
  -        <a href="proposals/release-plan-1.1rc2.html">Release Plan 1.1-rc2</a>
  +        <a href="proposals/release-plan-1.1.html">Release Plan 1.1</a>
           </li>
   
           <li>
  @@ -293,6 +293,10 @@
   
           <ul>
               <li>
  +                Remember to update the <a href="news/index.html">Status section of the News page</a> when cutting any milestone.
  +                For a final release, also update the /doc/project.xml with the current release number.
  +            </li>
  +            <li>
                   The release process can seem daunting when you review it for the first time.
                   But, essentially, it breaks down into three phases of just a few steps each:
                   <ul>
  @@ -490,13 +494,13 @@
   
   <section>
       <p align="right">
  -    Next: <a href="userGuide/index.html">Struts User Guide</a>
  +    Next: <a href="news/index.html">News and Status</a>
       </p>
   </section>
   
   <section>
  -    <p><font size="-2">Website updated from CVS: 2003 MAR 18 by husted.</font></p>
  -    <p><font size="-2">Javadocs updated from CVS: 2003 FEB 15 by husted.</font></p>
  +    <p><font size="-2">Website updated from CVS: 2003 JUL 04 by husted.</font></p>
  +    <p><font size="-2">Javadocs updated from CVS: 2003 JUN 29 by mcooper.</font></p>
   </section>
   
   </chapter></body></document>
  
  
  
  1.38      +2 -26     jakarta-struts/doc/project.xml
  
  Index: project.xml
  ===================================================================
  RCS file: /home/cvs/jakarta-struts/doc/project.xml,v
  retrieving revision 1.37
  retrieving revision 1.38
  diff -u -r1.37 -r1.38
  --- project.xml	29 Jun 2003 05:32:19 -0000	1.37
  +++ project.xml	4 Jul 2003 17:37:32 -0000	1.38
  @@ -85,8 +85,8 @@
           	/>
       </menu>
   
  -    <menu name="Stable Release (1.1)">
  -        <item 
  +    <menu name="Stable Release (1.1.0)">
  +        <item
           	name="Release Notes"
               href="userGuide/release-notes-1.1.html"
               />
  @@ -95,30 +95,6 @@
               href="proposals/release-plan-1.1.html"
               />
       </menu>
  -
  -    <menu name="Previous Release (1.0.2)">
  -        <item 
  -        	name="Welcome page"
  -            href="http://jakarta.apache.org/struts/doc-1.0.2/index.html"
  -            />
  -        <item 
  -        	name="User Guide"
  -            href="http://jakarta.apache.org/struts/doc-1.0.2/userGuide/index.html"
  -            />
  -        <item 
  -        	name="Javadoc"
  -            href="http://jakarta.apache.org/struts/doc-1.0.2/api/index.html"
  -            />
  -        <item 
  -        	name="Release Notes"
  -            href="http://jakarta.apache.org/struts/doc-1.0.2/release-notes-1.0.2.html"
  -            />
  -        <item 
  -        	name="Installation"
  -            href="http://jakarta.apache.org/struts/doc-1.0.2/installation.html"
  -            />
  -    </menu>
  -
   
   </project>
   
  
  
  
  1.9       +2 -6      jakarta-struts/doc/learning.xml
  
  Index: learning.xml
  ===================================================================
  RCS file: /home/cvs/jakarta-struts/doc/learning.xml,v
  retrieving revision 1.8
  retrieving revision 1.9
  diff -u -r1.8 -r1.9
  --- learning.xml	3 Jul 2003 01:55:52 -0000	1.8
  +++ learning.xml	4 Jul 2003 17:37:32 -0000	1.9
  @@ -48,11 +48,7 @@
       When learning about Struts, <b>be sure to refer to the documentation for 
       the version you are actually using</b>. 
       The documentation is bundled with each distribution as an application that 
  -    you can install locally. 
  -    For your convenience, links to the documentation for the current stable 
  -    release are also provided on the menu bar. 
  -    Whenever possible, please help conserve our bandwidth and install the 
  -    documentation locally.
  +    you can install and use locally.
       </blockquote>
   
       <p>
  @@ -173,7 +169,7 @@
   
       <p>
       The Struts <a href="resources/index.html"><b>Resources</b></a> page 
  -    provides links to everything else published about Struts, including:
  +    provides links to other material published about Struts, including:
       </p>
       
       <ul>
  
  
  
  1.45      +0 -7      jakarta-struts/doc/index.xml
  
  Index: index.xml
  ===================================================================
  RCS file: /home/cvs/jakarta-struts/doc/index.xml,v
  retrieving revision 1.44
  retrieving revision 1.45
  diff -u -r1.44 -r1.45
  --- index.xml	7 Jun 2003 12:24:24 -0000	1.44
  +++ index.xml	4 Jul 2003 17:37:32 -0000	1.45
  @@ -164,12 +164,5 @@
      </p>
   </section>
   
  -<section>
  -   <p align="center">
  -   <a href="./faqs/helping.html#release">So when is the next release coming 
  -   out?</a>
  -   </p>
  -</section>
  -
   </body>
   </document>
  
  
  
  1.12      +22 -92    jakarta-struts/doc/acquiring.xml
  
  Index: acquiring.xml
  ===================================================================
  RCS file: /home/cvs/jakarta-struts/doc/acquiring.xml,v
  retrieving revision 1.11
  retrieving revision 1.12
  diff -u -r1.11 -r1.12
  --- acquiring.xml	15 May 2003 02:58:50 -0000	1.11
  +++ acquiring.xml	4 Jul 2003 17:37:32 -0000	1.12
  @@ -14,81 +14,38 @@
   </properties>
   
   <body>
  -<section name="Acquiring Struts" href="Acquiring">
  +
  +    <section name="Acquiring Struts" href="Acquiring">
   
       <p>
  -    The <i>production release</i> of <strong>Struts 1.0.2</strong> is 
  -    available in a convenient binary distribution and also with complete 
  +    The lastest <i>production release</i> of Struts is
  +    available in a convenient binary distribution and also with complete
       source code. 
  -    In addition, a library distribution is available, which contains the 
  -    latest Struts binaries without the documentation or sample applications, 
  -    providing a smaller, faster download.
       </p>
   
  +        <p>
  +            Apache downloads are now mirrored.
  +            When you follow either the Binary or Source link,
  +            please select your preferred mirror and then click on the link
  +            to the <b>Struts</b> download.
  +        </p>
  +
       <ul>
           
       <li>
  -        <a href="http://jakarta.apache.org/builds/jakarta-struts/release/v1.0.2">
  -        <b>Struts 1.0.2 Binary Distribution</b></a>
  -    </li>
  -    
  -    <li>
  -        <a href="http://jakarta.apache.org/builds/jakarta-struts/release/v1.0.2/lib">
  -        <b>Struts 1.0.2 Library Distribution</b></a>
  +        <a href="http://jakarta.apache.org/site/binindex.cgi">
  +        <b>Struts Binary Distribution - Latest release</b></a>
       </li>
  -    
  +
       <li>
  -        <a href="http://jakarta.apache.org/builds/jakarta-struts/release/v1.0.2/src">
  -        <b>Struts 1.0.2 Source Code Distribution</b></a>
  +        <a href="http://jakarta.apache.org/site/sourceindex.cgi">
  +        <b>Struts Source Code Distribution - Latest Release</b></a>
       </li>
       
       </ul>
   
       <p>
  -    Check the
  -    <a href="http://jakarta.apache.org/struts/doc-1.0.2/release-notes-1.0.2.html">
  -    Release Notes</a> for a summary of the changes since the Struts 1.0.1 
  -    release.
  -    </p>
  -
  -    <p>
  -    <b>In addition to a Struts distribution,</b> you will need to ensure that
  -    you have downloaded and installed all of the
  -    <a href="http://jakarta.apache.org/struts/doc-1.0.2/installation.html#Prerequisites">
  -    prerequisite</a> software applications. 
  -    Then, follow the appropriate instructions to 
  -    <a href="http://jakarta.apache.org/struts/doc-1.0.2/installation.html#Installing">
  -    install and use a Struts binary distribution</a> in your web application 
  -    or for
  -    <a href="http://jakarta.apache.org/struts/doc-1.0.2/installation.html#Building">
  -    building Struts from the source distribution</a>.
  -    </p>
  -
  -    <p>
  -    A <i>release candidate</i> of <strong>Struts 1.1</strong> is also
  -    available, in the same three distributions. As a release candidate, this
  -    release is expected to be as stable as a production release, but there may
  -    be a few remaining issues which have not been previously encountered.
  -    </p>
  -
  -    <ul>
  -    <li><a href="http://www.apache.org/dist/jakarta/struts/binaries/">
  -    <b>Struts 1.1 Release Candidate 1 Binary Distribution</b></a></li>
  -    <li><a href="http://www.apache.org/dist/jakarta/struts/library/">
  -    <b>Struts 1.1 Release Candidate 1 Library Distribution</b></a></li>
  -    <li><a href="http://www.apache.org/dist/jakarta/struts/source/">
  -    <b>Struts 1.1 Release Candidate 1 Source Code Distribution</b></a></li>
  -    </ul>
  -
  -    <p>
  -    Check the
  -    <a href="http://jakarta.apache.org/struts/userGuide/release-notes-1.1-rc1.html">
  -    Release Notes</a> for a summary of the changes since the Struts 1.0.2 
  -    release.
  -    </p>
  -
  -    <p>
  -    As with the production release, you will need to ensure that you have
  +    <b>In addition to a Struts distribution,</b> you will need to ensure that you have
       downloaded and installed all of the
       <a href="http://jakarta.apache.org/struts/userGuide/installation.html#Prerequisites">
       prerequisite</a> software applications. 
  @@ -100,20 +57,6 @@
       building Struts from the source distribution</a>.
       </p>
       
  -    <p>   
  -    For your convenience, the requisite JARs are provided as a single download under 
  -    the <code>lib</code> sub-directory with each release and beta distribution. 
  -    (The "Library Distribution" above.)
  -    Please note that the minimum requirements may change between releases 
  -    and betas, and some JARs may need to be updated to use the latest 
  -    Nightly Build. 
  -    </p>
  -    
  -</section>
  -
  -<section>
  -    <p align="center"><a href="./faqs/helping.html#release">So when is the 
  -    next release coming out?</a></p>
   </section>
   
   <section name="Nightly Builds" href="Builds">
  @@ -147,24 +90,11 @@
       </ul>
       
       <p>
  -    The nightly build relies on several JARs from the 
  -    <a href="http://jakarta.apache.org/commons">Jakarta Commons</a>. 
  -    Nightly builds of all the Commons and Commons-Sandbox packages are  
  -    available from the 
  -    <a href="http://jakarta.apache.org/builds/jakarta-commons/nightly/">
  -    Commons nightly build directory</a>. 
  -    Binary JARs are also available from the Apache Gump 
  -    <a href="http://gump.covalent.net/jars/latest/">latest JARs 
  -    directory</a>. 
  -    (If you have trouble with a JAR after downloading it from Gump, 
  -    your browser may be interpreting it as a text file. 
  -    Try another browser or download the full distribution.)
  -    </p>
  -    
  -    <p>
  -    If you are building Struts from source, be sure to refer to the 
  -    <a href="userGuide/installation.html">Installation page</a> in the 
  -    User Guide for prerequesites.
  +        If you are building Struts from source, be sure to refer to the
  +        <a href="userGuide/installation.html">Installation page</a> in the
  +        User Guide for prerequesites.
  +        There are several JARs from the Jakarta Commons project that
  +        are required to build Struts.
       </p>
       
       <p>
  
  
  

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