husted 02/03/02 17:45:23
Modified: doc resources.xml news_2002.xml newbie.xml
kickstart.xml index.xml
Log:
Routine updates to news page, resources, FAQs, and home page.
Revision Changes Path
1.2 +26 -15 jakarta-struts/doc/resources.xml
Index: resources.xml
===================================================================
RCS file: /home/cvs/jakarta-struts/doc/resources.xml,v
retrieving revision 1.1
retrieving revision 1.2
diff -u -r1.1 -r1.2
--- resources.xml 20 Feb 2002 00:42:49 -0000 1.1
+++ resources.xml 3 Mar 2002 01:45:23 -0000 1.2
@@ -80,7 +80,7 @@
<p><a href="http://bist77.multimania.com/struts.php#rose";><b>Struts .. in
Rose</b></a> by Emmanuel.Boudrant - Use Struts with the Rational Rose UML model. </p>
<p><a
href="http://husted.com/struts/resources/multi-struts.htm";><b>Multi-Controller</b></a>
by Sukachevin, Stoehr - Use more than once ActionServlet in your Struts application
</p>
<p><a
href="http://www.mail-archive.com/struts-user@jakarta.apache.org/msg16093.html";><b>JavaScript
with html:errors - new Struts validation</b></a> by Adam Grohs. </p>
-<p><a href="http://jcorporate.com/";><b>Expresso</b></a> by jCorporate - Expresso
provides a foundation set of reusable, standards-based Java software components
designed to shorten time-to-delivery of Web applications, and is integrated with the
Struts framework. See also <a
href="http://www.xenonsoft.demon.co.uk/products/java.html";><b>Best Practice with
Expresso Framework 4.0</b></a>.</p>
+<p><a href="http://jcorporate.com/";><b>Expresso</b></a> by jCorporate - Expresso
provides a foundation set of reusable, standards-based Java software components
designed to shorten time-to-delivery of Web applications, and is integrated with the
Struts framework. See also <a
href="http://www.xenonsoft.demon.co.uk/products/java.html";>Best Practice with Expresso
Framework 4.0</a>.</p>
<p><a href="http://husted.com/struts/resources/DynamicProperties.htm";><b>Dynamic
ActionForm Properties</b></a> by Jan Sorensen.</p>
<p><a href="http://husted.com/struts/resources/bean-util.htm";><b>Bean Utils with
Indexed Strings</b></a> by Gregor Rayman.</p>
<p><a href="http://husted.com/struts/resources/struts-security.htm";><b>Role-Based
Actions</b></a> by Nic Hobs. Set a security role for an Action from with
struts-config.</p>
@@ -89,7 +89,7 @@
<p><a href="http://www.rpsenterprises.com/struts/index.html";><b>Struts
Extender</b></a> by Ron Smith - Add extensions to the struts framework via entries in
the Struts configuration file.</p>
<p><a href="http://husted.com/struts/resources/mapper.htm";><b>Mapper
Framework</b></a> by Capco - The Mapper framework can be used for automating the
process of validating/converting/transferring data fields. <font size="2">(See README
to get started. Updated 18-JUL-2001.)</font></p>
<p><a href="http://www.sura.ru/~gonza/bean-factory/";><b>Bean factory</b></a> by
Oleg V Alexeev - Adds the ability to easily link data bean creation to any Struts
Action. All information about databeans and actions mappings stored in the standard
Struts configuraton file. </p>
-<p><a href="http://husted.com/struts/resources/workflow.htm";><b>Workflow
Extension</b></a> by Matthias Bauer - An extension to the core Struts framework which
provides control flow between actions.</p>
+<p><a href="http://www.livinglogic.de/Struts/";><b>Workflow Extension</b></a> by
Matthias Bauer - An extension to the core Struts framework which provides control flow
between actions.</p>
<p><a href="http://husted.com/struts/resources/struts-menu.zip";><b>Struts
Menu</b></a> by Scott Sayles (ZIP file for download) - A Struts-compatible web menuing
component (early release - work in progress) - unzip to a "struts-menu"
folder, and see the README.</p>
<p><a href="http://home.earthlink.net/~dwinterfeldt/";><b>Struts Validator</b></a>
[<b>Also in the nightly build /contrib folder</b>] by David Winterfeldt - Perform
basic validations to check if a field is required, matches a regular expression, or
some other Javascript check, and some basic type checking. </p>
<p><a href="http://www.lifl.fr/~dumoulin/tiles/";><b>Tiles Library for building JSP
views</b></a> [<b>Also in the nightly build /contrib folder</b>] by Cedric Dumoulin -
A component is a JSP page that can be inserted in another JSP page, like templates,
but can take "parameters" (URLs or 'direct' string intemplates). See also <a
href="http://www.javaworld.com/javaworld/jw-01-2002/jw-0104-tilestrut.html";><b>UI
design with Tiles and Struts</b></a>.</p>
@@ -112,6 +112,7 @@
<section href="tutorials" name="Tutorials">
+<p><a href="http://www.anassina.com/struts/i18n/i18n.html";><b>Struts i18n</b></a>
by Aaron Rustad.</p>
<p><a href="http://husted.com/struts/resources/fb-auth.htm";><b>How To: (Form-Based
Authentication) use the form-error page to login</b></a> by Matt Raible.</p>
<p><a href="http://www.redbooks.ibm.com/redpieces/pdfs/sg246134.pdf";><b>WebSphere 4
Application Development Handbook</b></a> - IBM "Redbook" - See
"Designing with Frameworks (Chapter 7).</p>
<p><a href="http://husted.com/about/scaffolding/catalog.htm";><b>Struts
Catalog</b></a> by Ted Husted - Overview of Struts Design Patterns and Strategies.</p>
@@ -130,6 +131,8 @@
<section href="articles" name="Articles">
+<p><a
href="http://stealthis.athensgroup.com/presentations/Model_Layer_Framework/Struts_Whitepaper.doc";><b>Using
Struts</b></a> (Word document) by Larry Maturo</p>
+<p><a href="http://www.javaworld.com/javaworld/jw-02-2002/jw-0215-ssl.html";><b>Mix
protocols transparently in Web applications</b></a> by Steve Ditlinger.</p>
<p><a
href="http://www.theserverside.com/events/videos/CraigMcClanahan/dsl/interview.html";><b>About
Struts Interview With Craig McClanahan</b></a> - The Server Side.</p>
<p><a
href="http://www.javaworld.com/javaworld/jw-02-2002/jw-0201-strutsxslt.html";><b>Boost
Struts with XSLT and XML</b></a> By Julien Mercay and Gilbert Bouzeid.</p>
<p><a href="http://www.sysdeo.com/docs/struts1.pdf";><b>Struts, vous avez dit
Struts?</b></a> (in french) by Arnaud Buisine </p>
@@ -141,7 +144,7 @@
<p><a href="http://www.javadude.com/articles/layering.html";><b>Layering
Applications</b></a> by Scott Stanchfield.</p>
<p><a href="http://www.sys-con.com/java/article.cfm?id=1175";><b>MVC and
Struts</b></a> by Steven Sweeting, Clive Jones, and Aaron Rustad.</p>
<p><a
href="http://www.onjava.com/pub/a/onjava/2001/09/11/jsp_servlets.html";><b>Introduction
to Jakarta Struts Framework</b></a> by Sue Spielman.<br/>- <a
href="http://www.onjava.com/pub/a/onjava/2001/10/31/struts2.html";><b>Learning Jakarta
Struts, Part 2</b></a></p>
-<p><a href="http://husted.com/scaffolding/performant.htm";><b>Is Struts
Performant?</b></a> by Ted Husted -- An analysis of framework components, and how they
contribute to overall efficiency.</p>
+<p><a href="http://husted.com/struts/resources/performant.htm";><b>Is Struts
Performant?</b></a> by Ted Husted -- An analysis of framework components, and how they
contribute to overall efficiency.</p>
<p><a href="http://husted.com/struts/resources/strutsforeveryone.zip";><b>Struts for
Everyone</b></a> by Jonathan Asbell -- Word document zipped for download. Early
release: still in working draft form.</p>
<p><a
href="http://husted.com/struts/resources/1291-authentication.zip";><b>Approaches to
User Authentication and Access Control in Web Applications</b></a> by Craig
McClanahan. Slides from the JavaOne BOF (June 2001 #1291). Star Office Format. Zipped
for download.</p>
<p><b>Support your application development with Struts</b> <font
color="#FF0000">[<a
href="http://www.sys-con.com/java/archives/0603/mcclanahan/";>404</a>]</font> by
McClanahan, McCay, and Bergenholtz.</p>
@@ -155,17 +158,17 @@
<section href="books" name="Books">
- <ul>
- <li><a
href="http://www.amazon.com/exec/obidos/ISBN=0971661901/hitchhikeguidetoA/";><b>Struts
Fast Track: J2EE / JSP Framework</b></a><b> </b>by Victor Cekvenich - Practical
Application with Database Access and Struts Extensions</li>
- <li><a
href="http://www.amazon.com/exec/obidos/ISBN=1861005512/hitchhikeguidetoA/";><b>Professional
JSP Site Design</b></a> - Wrox book - Features Struts throughout.</li>
- <li><a
href="http://www.amazon.com/exec/obidos/ISBN=0735710953/hitchhikeguidetoA/";><b>JSP and
Tag Libraries for Web Development </b></a>- by Wellington L. S. Da Silva. Several
chapters regarding Struts.</li>
- <li><a
href="http://www.redbooks.ibm.com/redpieces/pdfs/sg246134.pdf";><b>Websphere Version 4
Application Development Handbook</b></a> <font size="1">(PDF)</font> - Chapter 7
covers designing with both the Struts and Websphere frameworks,</li>
- <li><a
href="http://shannon.informatik.fh-wiesbaden.de/jsp/index.html";><b>Java Server Pages
and J2EE Web-based Applications for Enterprises</b></a> - In German, with a Chapter
regarding MVC and Struts.</li>
- <li><a
href="http://www.amazon.com/exec/obidos/ISBN=0130648841/hitchhikeguidetoA/";><b>Core
J2EE Patterns</b></a> - Many of these patterns are deployed in Struts.</li>
- <li><a
href="http://www.amazon.com/exec/obidos/ISBN=1861004958/hitchhikeguidetoA/";><b>Professional
JSP 2nd Edition</b></a> - Wrox book - long chapter on Struts.</li>
- <li><a
href="http://www.amazon.com/exec/obidos/ISBN=0130307041/hitchhikeguidetoA/";><b>Advanced
JavaServer Pages</b></a> by David Geary - Features template tag library from Struts
1.0</li>
- <li><a
href="http://www.amazon.com/exec/obidos/ISBN=0201633612/hitchhikeguidetoA/";><b>Design
Patterns: Elements of Reusable Object-Orientated Software</b></a> by Gama, Helm,
Johnson, and Vlissides - Inspired the core patterns used by Struts.</li>
- </ul>
+<ul>
+<li><a
href="http://www.amazon.com/exec/obidos/ISBN=0971661901/hitchhikeguidetoA/";><b>Struts
Fast Track: J2EE / JSP Framework</b></a><b> </b>by Victor Cekvenich - Practical
Application with Database Access and Struts Extensions</li>
+<li><a
href="http://www.amazon.com/exec/obidos/ISBN=1861005512/hitchhikeguidetoA/";><b>Professional
JSP Site Design</b></a> - Wrox book - Features Struts throughout.</li>
+<li><a
href="http://www.amazon.com/exec/obidos/ISBN=0735710953/hitchhikeguidetoA/";><b>JSP and
Tag Libraries for Web Development </b></a>- by Wellington L. S. Da Silva. Several
chapters regarding Struts.</li>
+<li><a href="http://www.redbooks.ibm.com/redpieces/pdfs/sg246134.pdf";><b>Websphere
Version 4 Application Development Handbook</b></a> <font size="1">(PDF)</font> -
Chapter 7 covers designing with both the Struts and Websphere frameworks,</li>
+<li><a href="http://shannon.informatik.fh-wiesbaden.de/jsp/index.html";><b>Java
Server Pages and J2EE Web-based Applications for Enterprises</b></a> - In German, with
a Chapter regarding MVC and Struts.</li>
+<li><a
href="http://www.amazon.com/exec/obidos/ISBN=0130648841/hitchhikeguidetoA/";><b>Core
J2EE Patterns</b></a> - Many of these patterns are deployed in Struts.</li>
+<li><a
href="http://www.amazon.com/exec/obidos/ISBN=1861004958/hitchhikeguidetoA/";><b>Professional
JSP 2nd Edition</b></a> - Wrox book - long chapter on Struts.</li>
+<li><a
href="http://www.amazon.com/exec/obidos/ISBN=0130307041/hitchhikeguidetoA/";><b>Advanced
JavaServer Pages</b></a> by David Geary - Features template tag library from Struts
1.0</li>
+<li><a
href="http://www.amazon.com/exec/obidos/ISBN=0201633612/hitchhikeguidetoA/";><b>Design
Patterns: Elements of Reusable Object-Orientated Software</b></a> by Gama, Helm,
Johnson, and Vlissides - Inspired the core patterns used by Struts.</li>
+</ul>
</section>
@@ -178,6 +181,13 @@
<section href="archives" name="Mailing List Archives">
+<blockquote>
+ <ul>
+ <li><a href="http://www.tuxedo.org/~esr/faqs/smart-questions.html";><b>How To
Ask Questions The Smart Way</b></a></li>
+ <li><a href="http://expita.com/nomime.html";>Turn off HTML</a></li>
+ <li><a href="http://www.chiark.greenend.org.uk/~sgtatham/bugs.html";>How to
Report Bugs Effectively</a></li>
+ </ul>
+</blockquote>
<p><a href="http://mail-archive.com/";><b>mail-archive.com</b></a>.</p>
<p><a href="http://news.basebeans.com/forums.jsp";><b>BaseBeans Struts
Newsgroup</b></a></p>
<p><a href="http://archive.covalent.net/";><b>covalent.net</b></a>.</p>
@@ -282,6 +292,7 @@
<li><a href="http://www.pizzahut.com.au/";><b>Pizza Hut Online / Sydney
Metro</b></a> - For pickup or delivery in the Syndey Metro area.</li>
<li><!-- href="http://www.penza.ru/povolgie"--><b>Povoglie</b> [403] -
Goverment regional press services news center in Russia, middle Volga.</li>
<li><a href="http://www.ipayment.co.za";><b>South African Revenue
Services</b></a> - Directive and certificate service.</li>
+ <li><a
href="http://www.citlocate.com/cit-framework/citExampleWelcome.jsp";><b>SpatialFX</b></a></li>
<li><a href="http://www.redgalleon.com/";><b>Red Galleon</b></a> - Offer
aggregator.</li>
<li><a href="http://www.webappcabaret.com/teatimej/";><b>TeaTimeJ</b></a> -
Website and Java hosting.</li>
<li><a href="http://www.webappwriter.com/";><b>webAppWriter</b></a> - write and
deploy a J2EE app in 15 minutes.</li>
@@ -301,7 +312,7 @@
<li><b>Bravepoint</b> - <a
href="http://www.bravepoint.com";>www.bravepoint.com</a> - <a
href="mailto:[EMAIL PROTECTED]";>Struts Info</a>.</li>
<li><b>Creatrix</b> - <a href="http://www.creatrixs.com";>www.creatrixs.com</a> -
<a href="mailto:[EMAIL PROTECTED]";>[EMAIL PROTECTED]</a>.</li>
<li><b>eBlox</b> - <a href="http://www.eblox.com/";>www.eblox.com</a> - <a
href="mailto:[EMAIL PROTECTED]";>[EMAIL PROTECTED]</a>.</li>
- <li><b>Husted dot Com</b> - <a href="http://husted.com/";>www.husted.com</a> -
<a href="mailto:[EMAIL PROTECTED]";>Ted Husted</a>.</li>
+ <li><b>Husted dot Com</b> - <a
href="http://husted.com/about/services";>www.husted.com</a> - <a
href="mailto:[EMAIL PROTECTED]";>Ted Husted</a>.</li>
<li><b>Indaco Informatica</b> - <a
href="http://www.indaco.net/";>www.indaco.net</a> - <a
href="mailto:[EMAIL PROTECTED]";>Massimo Vassalli</a>.</li>
<li><font size="1"><b>JATEC AG</b></font> - <a href="http://www.jatec.ch";>
www.jatec.ch</a> - <a href="mailto:[EMAIL PROTECTED]";>Sascha Urfer</a>.</li>
<li><b>jCorporate</b> - <a href="http://www.jcorporate.com";>jcorporate.com</a> -
<a href="mailto:[EMAIL PROTECTED]";>Sandra Cann</a>.</li>
1.2 +96 -0 jakarta-struts/doc/news_2002.xml
Index: news_2002.xml
===================================================================
RCS file: /home/cvs/jakarta-struts/doc/news_2002.xml,v
retrieving revision 1.1
retrieving revision 1.2
diff -u -r1.1 -r1.2
--- news_2002.xml 20 Feb 2002 00:42:49 -0000 1.1
+++ news_2002.xml 3 Mar 2002 01:45:23 -0000 1.2
@@ -13,6 +13,29 @@
<section name="News & Status">
+<h3>01 Mar 2002 - Simper 0.2</h3>
+
+<p>
+Simper is a simple JDBC persistence mechanism for Java web apps. It
+features many of the interesting features of EJB, such as automatic
+transaction demarcation (by way of Servlet Filters), and automatic
+change detection of database rows (by way of DynaBeans). Lastly, the
+notation by which you reference rows, as well as relations between
+tables, is extremely JSP friendly.
+</p>
+<p>
+<a href="http://www.netmeme.org/simper/";>http://www.netmeme.org/simper/</a>
+</p>
+<p>
+0.2 is not a new release (it's been out for about a month), but, a
+SourceForge project has been set up, with mailing lists, CVS, etc., so
+that others can discuss and contribute (as I am getting quite busy
+lately)
+</p>
+<hr size="1" noshade=""/>
+
+
+
<h3><a name="20020212"></a>12 February 2002 - Stxx for transforming XML</h3>
<p>
@@ -105,6 +128,52 @@
<hr size="1" noshade=""/>
+<h3>6 February 2002 - Struts Console v1.4</h3>
+<p>
+Struts Console version 1.4 is now available.
+</p>
+<p>
+<a href="http://www.jamesholmes.com/struts/";>
+http://www.jamesholmes.com/struts/</a><br/>
+<a href="http://www.jamesholmes.com/struts/struts-console-1.4.zip";>
+http://www.jamesholmes.com/struts/struts-console-1.4.zip</a>
+</p>
+<p>
+This release adds plugin support for the new Oracle
+JDeveloper 9i IDE. This release also adds significant
+new funcionality to the "JSP Converter" and renames it
+to "Page Converter".
+</p>
+<hr size="1" noshade=""/>
+
+
+<h3>26 January 2002 - Free Struts Development Tool</h3>
+<p>
+"ObjectAssembler Standard is focused on supporting developers whose sole
+area of concern is developing Servlets, JSPs, JavaBeans and Struts
+components. It provides a visual development and code synchronization
+environment for the creation and assembly of these components into web
+applications."
+</p>
+<p>
+Here is the download page:<br/>
+<a href="http://www.objectventure.com/products/objectassembler.html";>
+http://www.objectventure.com/products/objectassembler.html</a>
+</p>
+<p>
+Here is a Viewlet showing some of ObjectAssembler's features:<br/>
+<a href="http://www.objectventure.com/demo/IntroStruts_viewlet.html";>
+http://www.objectventure.com/demo/IntroStruts_viewlet.html</a>
+</p>
+<p>
+Please give it a try and tell us what you think. We are currently working on
+our next major release that will provide J2EE 1.3 support. We also plan to
+support Struts as it evolves (multi-app support, etc.), so any input we
+receive would make that support even better.
+</p>
+<hr size="1" noshade=""/>
+
+
<h3><a name="20020118"></a>18 Jan 2002 - Nested Taglib added to nightly build</h3>
<p>
Struts tags support a dotted notation to refer to a nested beans. The Nested
@@ -117,10 +186,37 @@
<hr size="1" noshade=""/>
+<h3>17 January 2002 - Chiki v0.23</h3>
+<p>
+Chiki is a Wiki-like webapp built using Struts. This is the first
+publicly available release, so as much feedback as possible would be
+greatly appreciated.
+</p>
+<p>
+Chiki can be found at:<br/>
+<a href="http://chiki.emaho.org";>
+http://chiki.emaho.org </a>
+</p>
+<hr size="1" noshade=""/>
+
+
<h3>14 January 2002 - New Committer, Arron Bates </h3>
<p>
Arron Bates, known for his interesting and popular nesting extension to
the Struts taglibs has been elected as a Struts Committer.
+</p>
+<hr size="1" noshade=""/>
+
+
+<h3>13 Janaury 2002 - Scioworks Camino v1.0</h3>
+<p>
+We are pleased to announce the general availability of the Scioworks Camino
+v1.0, visual tool for Struts application development.
+</p>
+<p>
+Download is available at <br/>
+<a href="http://www.scioworks.com/scioworks_camino_download.html.";>
+http://www.scioworks.com/scioworks_camino_download.html.;</a>
</p>
<hr size="1" noshade=""/>
1.3 +31 -3 jakarta-struts/doc/newbie.xml
Index: newbie.xml
===================================================================
RCS file: /home/cvs/jakarta-struts/doc/newbie.xml,v
retrieving revision 1.2
retrieving revision 1.3
diff -u -r1.2 -r1.3
--- newbie.xml 24 Feb 2002 01:13:13 -0000 1.2
+++ newbie.xml 3 Mar 2002 01:45:23 -0000 1.3
@@ -8,7 +8,7 @@
<chapter href="faq" name="Newbie FAQ">
<section href="contents" name="Table of Contents">
<p><font color="red"><b>UNDER CONSTRUCTION</b></font> (contributions welcome)</p>
-<p>Here are answers to twenty common questions people ask when using Struts on
+<p>Here are answers to 21 common questions people ask when using Struts on
their first project. <b>For an in-depth, searchable FAQ, visit our friends at <a
href="http://www.jguru.com/faq/home.jsp?topic=Struts";>JGuru</a>.</b></p>
<ul>
<li>Why is ActionForm a base class rather than an interface?</li>
@@ -16,16 +16,17 @@
<li>Can I use other beans or hashmaps with ActionForms?</li>
<li>How can I prepopulate a form?</li>
<li>Can I use multiple HTML form elements with the same name?</li>
- <li><a href="#actionforms">hy are my checkboxes not being set from ON to
OFF?</a></li>
+ <li><a href="#actionforms">Why are my checkboxes not being set from ON to
OFF?</a></li>
<li>How can I capture binary or formatted values, like dates or telephone
numbers?</li>
<li>Why do my option lists disappear when validation fails?</li>
- <li>Can't I just create some of my JavaBeans on the JSP using a scriptlet?</li>
+ <li><a href="#scriptlets">Can't I just create some of my JavaBeans in the JSP
using a scriptlet?</a></li>
<li>When is the best time to validate input?</li>
<li>How can I avoid validating a form before data is entered?</li>
<li>How can I create a "wizard" workflow?</li>
<li>How can I "chain" Actions?</li>
<li>Can I have an Action without a form?</li>
<li>How do I access my database?</li>
+ <li>How can I authenticate my users?</li>
<li>Can I have multiple submit buttons on the same form?</li>
<li>Why can't my Javascript submit a form?</li>
<li>Can I create dynamic ActionFowards?</li>
@@ -67,5 +68,32 @@
when the ActionForm might kept in session scope.
</p>
</section>
+
+<section href="scriptlets" name="Can't I just create some of my JavaBeans in the
JSP using a scriptlet?">
+<p>
+Struts is designed to encourage a
+<a href="http://www.javaworld.com/javaworld/jw-12-1999/f_jw-12-ssj-jspmvc.html";>
+Model 2/MVC architecture</a>. But there is nothing that prevents you from using
Model 1
+techniques in your JavaServer Pages, so the answer to the question is "Yes, you
can".
+</p>
+<p>
+Though, using Model 1 techniques in a Struts application does go against the grain.
+The approach recommended by most Struts developers is to create and populate
whatever
+objects the view may need in the Action, and then forward these through the
request.
+Some objects may also be created and stored in the session or application context,
+depending on how they are used.
+</p>
+<p>
+Likewise, there is nothing to prevent you from using scriptlets along with JSP
+tags in your pages. Though, many Struts developers report writing very complex
+scriplet-free applications and recommend the JSP tag approach to others.
+</p>
+<p>
+For help with Model 1 techniques and scriptlets, you might consider joining the
+<a href="http://archives.java.sun.com/jsp-interest.html";>Javasoft JSP-interest
+mailing list</a>, where there are more people still using these approaches.
+</p>
+</section>
+
</chapter></body></document>
1.3 +14 -4 jakarta-struts/doc/kickstart.xml
Index: kickstart.xml
===================================================================
RCS file: /home/cvs/jakarta-struts/doc/kickstart.xml,v
retrieving revision 1.2
retrieving revision 1.3
diff -u -r1.2 -r1.3
--- kickstart.xml 24 Feb 2002 00:03:02 -0000 1.2
+++ kickstart.xml 3 Mar 2002 01:45:23 -0000 1.3
@@ -159,14 +159,24 @@
</section>
<section href="bugs" name="Where can I report bugs or make feature requests?">
-<p>You can research and report outstanding fixes and feature requests using <a
href="http://jakarta.apache.org/site/bugs.html";>Jakarta Bugzilla</a>.</p>
-<p>If you are unsure if this is in actual problem, feel free to bring it up on the
list first. But to be sure an issue is resolved, always report it to <a
href="http://jakarta.apache.org/site/bugs.html";>Bugzilla</a>.</p>
-<p>Struts also maintains a <a href="../todo-1.1.html">TODO list</a> outlining
features being planned or developed.</p>
+<p>You can research and report outstanding fixes and feature requests using
+<a href="http://jakarta.apache.org/site/bugs.html";>Jakarta Bugzilla</a>. If you
+are unsure if this is an actual problem, feel free to bring it up on the list
+first. But to be sure that an issue is resolved, read
+<a href="http://www.chiark.greenend.org.uk/~sgtatham/bugs.html";>How to Report
+Bugs Effectively</a> and report it to
+<a href="http://jakarta.apache.org/site/bugs.html";><b>Bugzilla</b></a>.</p>
+<p>Feature requests are also maintained in the Bugzilla database. Some older
+requests are still listed on the <a href="../todo-1.1.html">wish list</a>
+page.</p>
</section>
<section href="contribute" name="How can I contribute to the development of
Struts?">
<p>Struts is distributed by the <a href="http://apache.org/";>Apache Software
Foundation</a>. These are the same people who distribute the Apache Web server. Like
all ASF projects, Struts is managed as a "meritocracy", where everyone's
contribution is welcome. Users can help other users on the <a
href="http://jakarta.apache.org/site/mail.html";>mailing lists</a>, <a
href="http://jakarta.apache.org/site/bugs.html";>report bugs</a>, and <a
href="http://jakarta.apache.org/site/bugs.html";>request new features</a>. Developers
can contribute patches, new code, and documentation. The most active Developers may
become <a href="http://jakarta.apache.org/site/roles.html";>Committers</a>, who make
the actual decisions about the Strut's codebase.</p>
-<p>You can start by joining the Struts User list. If you enjoy participating there,
then sign up for the Struts Developer list too. If you find any problems with Struts,
or find a missing feature, you can enter a record to our <a
href="http://jakarta.apache.org/site/bugs.html";>Bugzilla</a> database.</p>
+<p>You can start by joining the Struts User list. If you enjoy participating there,
+then sign up for the Struts Developer list too. If you find any problems with
Struts,
+or find a missing feature, you can enter a record to our
+<a href="#bugs">Bugzilla</a> database.</p>
</section>
<section href="release" name="When is the next release coming out?">
1.17 +70 -25 jakarta-struts/doc/index.xml
Index: index.xml
===================================================================
RCS file: /home/cvs/jakarta-struts/doc/index.xml,v
retrieving revision 1.16
retrieving revision 1.17
diff -u -r1.16 -r1.17
--- index.xml 20 Feb 2002 00:42:49 -0000 1.16
+++ index.xml 3 Mar 2002 01:45:23 -0000 1.17
@@ -5,7 +5,7 @@
<author>Craig R. McClanahan</author>
<author>Ted Husted</author>
<author>Martin Cooper</author>
- <title>The Struts Framework Project</title>
+ <title>The Struts Web Application Framework</title>
</properties>
<body>
@@ -114,15 +114,20 @@
<p>
The Struts <a href="#Involved">Mailing Lists</a> are an treasure trove of useful,
interactive information. The list tends to carry a high volume, so always check
the
- published documentation and
- the <a href="http://www.mail-archive.com/struts-user%40jakarta.apache.org/";>
- <b>MAILING LIST ARCHIVE</b></a> before posting a new question. Like as not, it's
- already been asked and answered.
+ published documentation and the
+ <a href="http://www.mail-archive.com/struts-user%40jakarta.apache.org/";>
+ <b>MAILING LIST ARCHIVE</b></a> before
+ <a href="http://www.tuxedo.org/~esr/faqs/smart-questions.html";>posting a new
question</a>.
+ Like as not, it's already been asked and answered.
</p>
<p>
The Struts <a href="resources.html"><b>Resources</b></a> page provides links to
- everything else published about Struts, including books, articles, tutorials,
seminars,
+ everything else published about Struts, including
+ <a href="resources.html#books">books</a>,
+ <a href="resources.html#articles">articles</a>,
+ <a href="resources.html#tutorials">tutorials</a>,
+ <a href="resources.html#seminars">seminars</a>,
and sample applications. There are also links to public sites "Powered by Struts"
and
a directory of professional Struts consultants.
</p>
@@ -219,17 +224,47 @@
Apache Bug Database</a>. Please select <strong>Struts</strong> from the product
list, along with the details of which component of Struts you feel this report
relates to, and details of your operating environment. You will automatically be
- notified by email as the status of your bug or enhancement report changes.
+ notified by email as the status of your bug or enhancement report changes. Please
+ be sure to read
+ <a href="http://www.chiark.greenend.org.uk/~sgtatham/bugs.html";>How to Report
+ Bugs Effectively</a> before posting.
</p>
</section>
- <section name="Getting Involved" href="Involved">
+ <section name="Contributing Patches to Code or Documentation" href="Patches">
+
+ <p>
+ You can upload a proposed <a
href="http://jakarta.apache.org/site/source.html#Patches";>
+ patch</a> to either the code or documentation by creating a feature request in
+ <a href="#Bugs">Bugzilla</a>. <b>After creating the ticket</b>, you can go back
+ and upload a file containing your patch.
+ </p>
+ <p>
+ The documentation is maintained in the <code>doc</code> folder of the CVS in a
+ XML format. In the Nightly Build, there is a "compile.website" target in the
+ <code>build.xml</code> file, which renders the XML into the HTML we post to the
+ Website. If you would like to help with the documentation, it is important to
+ provide patches and new pages in the XML source. Otherwise, some other volunteer
+ will have to do this for you, and it may never get done. (Sad but true.) If you
+ are submitting new material, it is important to decide exactly where you would
+ put this in relation to the rest of the documentation. Someone has to figure that
+ out before it can be added, and that someone might as well be you.
+ </p>
+ <p>
+ New additions for the Resources page should be posted as an enhancement request
to
+ <a href="#Bugs">Bugzilla</a>.
+ </p>
+
+ </section>
+
+ <section name="Joining the Mailing Lists" href="lists">
<p>
- There are a number of ways to get more involved in the Struts
- community, including contributing to the future development of Struts.
- Check out the following resources:
+ Before joining any mailing list at Jakarta, please be sure to read the
+ <a href="http://jakarta.apache.org/site/mail.html";>Mailing Lists -
Guidelines</a>.
+ If you have read and understood these guidelines, you are welcome to join the
+ Jakarta Struts mailing lists:
</p>
<ul>
<li><strong>STRUTS-USER Mailing List</strong> - Subscribe to this list
@@ -256,24 +291,34 @@
[<a href="http://news.basebeans.com/forums.jsp";>Struts Newsgroup</a>]<br/>
Our thanks to BaseBeans Engineering for providing this much-needed service!
</li>
- <li><strong>Bug Reports and Feature Requests</strong> Use the
- <a href="#Bugs">Bug Reporting System</a> to submit these reports.</li>
- <li><strong>Patches and Modules</strong> - You can contribute patches and
- new modules to Struts by posting them to the STRUTS-DEV mailing list.
- After discussion and acceptance, one of the existing Committers will
- add your contribution to the Struts source code base (with credit to
- you, of course).</li>
- <li><strong>Become A Committer</strong> - If you wish to contribute directly
- to the development of Struts, and have commit access to the CVS source
- repository, you can be nominated (or nominate yourself) for Committer
- status on this project. The rules by which committers are voted on are
- listed at the
- <a href="http://jakarta.apache.org/guidelines/index.html";>Jakarta
- web site</a>.</li>
</ul>
</section>
+ <section name="Posting a Question to a Mailing List" href="questions">
+
+ <p>
+ Before posting a new question, be sure to consult the
+ <a href="http://www.mail-archive.com/struts-user%40jakarta.apache.org/";>
+ <b>MAILING LIST ARCHIVE</b></a> and the very excellent
+ <a href="http://www.tuxedo.org/~esr/faqs/smart-questions.html";>
+ How To Ask Questions The Smart Way</a> by Eric Raymond. Please do be sure
+ to <a href="http://expita.com/nomime.html";>turn off HTML</a> in your
+ email client before posting.
+ </p>
+
+ </section>
+
+ <section name="Getting Involved" href="Involved">
+
+ <p>
+ All work on Struts and the other Jakarta subprojects is provided a volunteer
+ basis. For more about what you can do, see the
+ <a href="http://jakarta.apache.org/site/getinvolved.html";>Getting Involved
+ Overview</a>.
+ </p>
+
+ </section>
</body>
</document>
--
To unsubscribe, e-mail: <mailto:[EMAIL PROTECTED]>
For additional commands, e-mail: <mailto:[EMAIL PROTECTED]>
