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 2002/03/03 02:45:24 UTC
cvs commit: jakarta-struts/doc resources.xml news_2002.xml newbie.xml kickstart.xml index.xml
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:struts@bravepoint.com">Struts Info</a>.</li>
<li><b>Creatrix</b> - <a href="http://www.creatrixs.com">www.creatrixs.com</a> - <a href="mailto:sami.elhini@creatrixs.com">sami.elhini@creatrixs.com</a>.</li>
<li><b>eBlox</b> - <a href="http://www.eblox.com/">www.eblox.com</a> - <a href="mailto:andrewb@eblox.com">andrewb@eblox.com</a>.</li>
- <li><b>Husted dot Com</b> - <a href="http://husted.com/">www.husted.com</a> - <a href="mailto:ted@husted.com">Ted Husted</a>.</li>
+ <li><b>Husted dot Com</b> - <a href="http://husted.com/about/services">www.husted.com</a> - <a href="mailto:ted@husted.com">Ted Husted</a>.</li>
<li><b>Indaco Informatica</b> - <a href="http://www.indaco.net/">www.indaco.net</a> - <a href="mailto:massimo@ino.it">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:sascha.urfer@jatec.net">Sascha Urfer</a>.</li>
<li><b>jCorporate</b> - <a href="http://www.jcorporate.com">jcorporate.com</a> - <a href="mailto:scann@jcorporate.com">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: <ma...@jakarta.apache.org>
For additional commands, e-mail: <ma...@jakarta.apache.org>