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 2006/02/18 14:50:45 UTC

svn commit: r378721 - /struts/site/trunk/xdocs/kickstart.fml

Author: husted
Date: Sat Feb 18 05:50:41 2006
New Revision: 378721

URL: http://svn.apache.org/viewcvs?rev=378721&view=rev
Log:
Site Kickstart FAQ 
* Add questions regarding subproject release strategy. 

Modified:
    struts/site/trunk/xdocs/kickstart.fml

Modified: struts/site/trunk/xdocs/kickstart.fml
URL: http://svn.apache.org/viewcvs/struts/site/trunk/xdocs/kickstart.fml?rev=378721&r1=378720&r2=378721&view=diff
==============================================================================
--- struts/site/trunk/xdocs/kickstart.fml (original)
+++ struts/site/trunk/xdocs/kickstart.fml Sat Feb 18 05:50:41 2006
@@ -27,6 +27,93 @@
 
     <part>
         <title>Product Line</title>
+
+        <faq id="subprojects">
+            <question>Why are there so many subprojects now?</question>
+            <answer>
+                <p>
+                    Over the years, the Action framework grew to include not only a
+                    controller and a set of taglibs but several other extensions,
+                    like Tiles, EL, Scripting, and Flow. There were also some
+                    optional classes that some people liked, but not everyone needed
+                    (like DispatchAction).
+                </p>
+
+                <p>
+                    Releasing all of this code together has been like hanging wall
+                    paper. We smooth a crease here, and another wrinkle crops up over
+                    there. In order to promote lighter, regular releases, we've
+                    subdivided the monolithic Struts 1.2 distribution into seven
+                    distinct subprojects: Action, EL, Extras, Site, Taglib, and
+                    Tiles.
+                </p>
+
+                <p>
+                    Now, if we want to make a change to a JSP tag, we can release
+                    Taglib without re-releasing everything else. Likewise, if we want
+                    to add a nifty new Action to Extras, we can just release Extras,
+                    without re-releasing everything else.
+                </p>
+
+                <p>
+                    Of course, the next question is: "Which versions of work with the
+                    "best available" release of Action?" To answer that question,
+                    we provide the Struts Action Library, which contains the set of
+                    JARs that work with the "best available" release of Action.
+                </p>
+            </answer>
+        </faq>
+
+        <faq id="dependencies">
+            <question>
+                But what if a new feature in Taglibs depends on a new feature in
+                Action? Won't you still have to release them together?
+            </question>
+            <answer>
+                <p>
+                    Hmmm, almost. This sort of thing already happens with the Commons
+                    components. We might have to release a new version of Commons
+                    Validator and test it against the development build of Struts
+                    Action. The same thing would continue to happen. It's just
+                    instead of
+                    being a Commons component and a Struts component, it's two
+                    Struts components. No big woof.
+                </p>
+                <p>
+                    The difference is that now we get to choose what is released
+                    together. The infrastructure does not make that decision for us.
+                </p>
+            </answer>
+        </faq>
+
+        <faq id="confusing">
+            <question>Won't it be confusing for people to bundle, say, Action 1.3.4
+                with Taglib 1.3.2?</question>
+            <answer>
+                <p>
+                    We also bundle Action 1.3.0 with Commons-Validator 1.2.0.
+                    and Commons-BeanUtils 1.7.0, and several other JARs with their
+                    own version numbers. Same difference.
+                </p>
+                <p>
+                    To make it easy for people to grab the "best available"
+                    combination of JARs, we offer the Struts Action Library.
+                </p>
+            </answer>
+        </faq>
+
+        <faq id="classic">
+            <question>Is Struts Classic another name for the Struts Action Framework?
+            </question>
+            <answer>
+                <p>Struts Classic is a codename for the work we needed to do to
+                    create and release the seven new subprojects we extracted from
+                    Struts 1.2. It is not a product per-se, but shorthand for the
+                    1.3.0 build of the seven projects.
+                </p>
+            </answer>
+        </faq>
+
         <faq id="shale">
             <question>Why are you offering both Struts Shale and Struts Action
                 Framework? Don't they compete for new development?</question>
@@ -110,51 +197,51 @@
         </faq>
 
         <faq id="ti">
-        <question>What about Ti? What about WebWork?</question>
-        <answer>
-        <p>
-            <a href="http://wiki.apache.org/struts/StrutsTi">Struts
-                Ti</a>
-            (short for Titanium) is a codename for Struts Action
-            Framework 2.x.
-            In late November 2005, the Ti proposal was amended to
-            include a merger with
-            <a href="http://www.opensymphony.com/webwork/">Open
-                Symphony WebWork</a>
-            .
-            Under this plan, the next stable release of WebWork is
-            being donated to Apache Struts,
-            and the lead WebWork committers are joining the Struts
-            community.
-            The WebWork codebase is being brought into the ASF through
-            the Apache Incubator.
-            Once licensing and related issues are resolved,
-            the codebase will be made part of the Apache Struts
-            framework.
-        </p>
-        <p>
-            WebWork started as a
-            <a href="http://incubator.apache.org/learn/rules-for-revolutionaries.html">
-                Struts Revolution</a>
-            .
-            Over the years, it has evolved into a superb action-based
-            framework that retains many Struts 1.x paradigms.
-        </p>
-        <p>
-            People who have worked with both Struts 1.x and WebWork
-            2.x tend to agree that it is a logical candidate for
-            Struts Action Framework 2.x.
-            If you look the Struts Action 1.x roadmap and the WebWork
-            2.x feature set,
-            you'll see that WebWork has already does most of what we
-            wanted Struts Action to do.
-            If we finished the roadmap ourselves, Struts Action would
-            end up as a WebWork workalike.
-            Rather than reinvent the wheel,
-            Ti has become a proposal to put the WebWork wheel back on
-            the Struts axle.
-        </p>
-        </answer>
+            <question>What about Ti? What about WebWork?</question>
+            <answer>
+                <p>
+                    <a href="http://wiki.apache.org/struts/StrutsTi">Struts
+                        Ti</a>
+                    (short for Titanium) is a codename for Struts Action
+                    Framework 2.x.
+                    In late November 2005, the Ti proposal was amended to
+                    include a merger with
+                    <a href="http://www.opensymphony.com/webwork/">Open
+                        Symphony WebWork</a>
+                    .
+                    Under this plan, the next stable release of WebWork is
+                    being donated to Apache Struts,
+                    and the lead WebWork committers are joining the Struts
+                    community.
+                    The WebWork codebase is being brought into the ASF through
+                    the Apache Incubator.
+                    Once licensing and related issues are resolved,
+                    the codebase will be made part of the Apache Struts
+                    framework.
+                </p>
+                <p>
+                    WebWork started as a
+                    <a href="http://incubator.apache.org/learn/rules-for-revolutionaries.html">
+                        Struts Revolution</a>
+                    .
+                    Over the years, it has evolved into a superb action-based
+                    framework that retains many Struts 1.x paradigms.
+                </p>
+                <p>
+                    People who have worked with both Struts 1.x and WebWork
+                    2.x tend to agree that it is a logical candidate for
+                    Struts Action Framework 2.x.
+                    If you look the Struts Action 1.x roadmap and the WebWork
+                    2.x feature set,
+                    you'll see that WebWork has already does most of what we
+                    wanted Struts Action to do.
+                    If we finished the roadmap ourselves, Struts Action would
+                    end up as a WebWork workalike.
+                    Rather than reinvent the wheel,
+                    Ti has become a proposal to put the WebWork wheel back on
+                    the Struts axle.
+                </p>
+            </answer>
         </faq>
 
         <faq id="xwork">
@@ -164,8 +251,10 @@
 
                 <p>
                     For the time being, there is no plan to migrate XWork to
-                    the ASF. Struts Action has always had many dependencies on external
-                    packages.So long as packages like XWork and Sitemesh are doing well
+                    the ASF. Struts Action has always had many dependencies on
+                    external
+                    packages.So long as packages like XWork and Sitemesh are doing
+                    well
                     at OpenSymphony, there is no reason to make further changes.
                 </p>
             </answer>
@@ -236,17 +325,6 @@
             </answer>
         </faq>
 
-        <faq id="action">
-            <question>What's the difference between Struts Action Framework
-                and Struts Classic?</question>
-            <answer>
-                <p>For the Struts Action Framework 1.3.x series, we subdivided
-                    the monolithic Struts 1.2.x distribution into several
-                    discrete subprojects. Struts Classic is a codename for the
-                    work we needed to do to create and release the new
-                    subprojects.</p>
-            </answer>
-        </faq>
     </part>
 
     <part>



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