husted 2002/08/14 08:21:14
Modified: doc index.xml
Log:
Add section to release note for fixes to beta 2. Other routine updates.
Revision Changes Path
1.28 +104 -134 jakarta-struts/doc/index.xml
Index: index.xml
===================================================================
RCS file: /home/cvs/jakarta-struts/doc/index.xml,v
retrieving revision 1.27
retrieving revision 1.28
diff -u -r1.27 -r1.28
--- index.xml 13 Aug 2002 16:28:48 -0000 1.27
+++ index.xml 14 Aug 2002 15:21:13 -0000 1.28
@@ -5,7 +5,7 @@
<author>Craig R. McClanahan</author>
<author>Ted Husted</author>
<author>Martin Cooper</author>
- <author>James Holmes</author>
+ <author>James Holmes</author>
<title>The Struts Web Application Framework</title>
</properties>
@@ -16,43 +16,30 @@
<p>
Welcome to Struts! The goal of this project
- is to provide an open source framework for building Web applications.
- The core of Struts is a flexible control layer based on standard
- technologies like
- <a href="http://java.sun.com/products/servlet";> Java Servlets</a>,
- <a href="http://java.sun.com/products/javabeans/";>JavaBeans</a>,
- <a
href="http://java.sun.com/docs/books/tutorial/i18n/resbundle/concept.html";>ResourceBundles</a>,
- and <a href="http://www.w3.org/XML/";>Extensible Markup Language</a> (XML).
- </p>
- <p>
- Struts encourages application architectures based on the Model 2 approach,
- a variation of the classic
- <a
href="http://java.sun.com/blueprints/guidelines/designing_enterprise_applications_2e/web-tier/web-tier5.html";><b>Model-View-Controller</b></a>
(MVC) design paradigm. Struts
- provides its own <b>Controller</b> component and integrates
- with other technologies to provide the Model and the View.
- For the <b>Model</b>, Struts can interact with any standard data
- access technology, including
- <a href="http://java.sun.com/products/ejb/index.html";>
- Enterprise Java Beans</a>,
- <a href="http://java.sun.com/products/jdbc/index.html";>
- JDBC</a>, and
- <a href="http://java.sun.com/products/jndi/index.html";>
- JNDI</a>.
- For the <b>View</b>, Struts works well with
- <a href="http://java.sun.com/products/jsp";>JavaServer
- Pages</a>,
- <a href="http://jakarta.apache.org/velocity/index.html";>
- Velocity Templates</a>,
- <a href="http://www.w3.org/TR/xslt";>XSLT</a>, and
- <a href="resources/views.html">
- other presentation systems
- </a>.
+ is to provide an open source framework for building Web applications.
+ The core of Struts is a flexible control layer based on <a
href="userGuide/preface.html">standard
+ technologies</a> like
+ Java Servlets,
+ JavaBeans,
+ ResourceBundles,
+ and Extensible Markup Language (XML).
+ </p>
+ <p>
+ Struts encourages application architectures based on the Model 2 approach,
+ a variation of the classic
+ <a
href="http://java.sun.com/blueprints/guidelines/designing_enterprise_applications_2e/web-tier/web-tier5.html";><b>Model-View-Controller</b></a>
(MVC) design paradigm. Struts
+ provides its own <b>Controller</b> component and integrates
+ with <a href="userGuide/preface.html#layers">other technologies</a> to provide
the Model and the View.
+ For the <b>Model</b>, Struts can interact with any
+ <a href="resources/models.html">standard data access technology</a>, including
Enterprise Java Beans, JDBC, and Object Relational Bridge.
+ For the <b>View</b>, Struts works well with JavaServer Pages, Velocity Templates,
+ XSLT, <a href="resources/views.html">other presentation systems</a>.
</p>
<p>
- The Struts framework provides the invisible underpinnings every
- professional Web application needs to survive. Struts helps you
- create an extensible development environment for your application,
+ The Struts framework provides the invisible underpinnings every
+ professional Web application needs to survive. Struts helps you
+ create an extensible development environment for your application,
based on published standards and proven design patterns.
</p>
@@ -69,110 +56,93 @@
<section name="Learning About Struts" href="Docs">
<p>
- The <b>official documentation</b> for the framework is provided both online
- and as a self-installing WAR in the distribution. The
- <code>struts-documentation.war</code> includes the
+ The <b>official documentation</b> for the framework is provided both online
+ and as a self-installing WAR in the distribution. The
+ <code>struts-documentation.war</code> includes the
<a href="kickstart.html">Kickstart</a> and
- <a href="newbie.html">Newbie</a> FAQs,
- <a href="userGuide/index.html">Users Guide</a>,
+ <a href="newbie.html">Newbie</a> FAQs,
+ <a href="userGuide/index.html">Users Guide</a>,
<a href="api/index.html">Javadocs</a>, and everything else you find here.
You are invited to preview the documentation online, and then install the
- application locally for closer study.
+ application locally for closer study.
</p>
<blockquote>
- Note: Most of the links in this section refer to the <b>Nightly Build</b>.
- 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. Links to the
- documentation for the current stable release (1.0.2) are also provided on the
- menu bar. Whenever possible, please help conserve our bandwidth, and install
+ Note: Most of the links in this section refer to the <b>Nightly Build</b>.
+ 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. Links to the
+ documentation for the current stable release (1.0.2) are also provided on the
+ menu bar. Whenever possible, please help conserve our bandwidth, and install
the documentation locally.
</blockquote>
<p>
- The <a href="kickstart.html"><b>Kickstart FAQ</b></a> answers the most common
- non-technical questions people first ask about Struts. The
- <a href="newbie.html">Struts Newbie FAQ</a> answers the most common
- technical questions asked by first-timer Struts developers. A more extensive
- Struts knowledgebase is available at the
- <a href="http://jguru.com/faq/Struts";>JGuru FAQ</a> and
+ The <a href="kickstart.html"><b>Kickstart FAQ</b></a> answers the most common
+ non-technical questions people first ask about Struts. The
+ <a href="newbie.html">Struts Newbie FAQ</a> answers the most common
+ technical questions asked by first-timer Struts developers. A more extensive
+ Struts knowledgebase is available at the
+ <a href="http://jguru.com/faq/Struts";>JGuru FAQ</a> and
<a href="http://jguru.com/forums/Struts";>Forum</a>.
</p>
<p>
- The concise Struts <a href="userGuide/index.html"><b>Users Guide</b></a>
introduces the
- Model-View-Controller architecture, and how it relates to the major components of
Struts.
- To help you get started with the Struts JSP tag extensions and utility packages,
- several <b>Developer Guides</b> supplement the Users Guide. The Users Guide also
- includes detailed installation instructions and release notes for each version of
the
+ The concise Struts <a href="userGuide/index.html"><b>Users Guide</b></a>
introduces the
+ Model-View-Controller architecture, and how it relates to the major components of
Struts.
+ To help you get started with the Struts JSP tag extensions and utility packages,
+ several <b>Developer Guides</b> supplement the Users Guide. The Users Guide also
+ includes detailed installation instructions and release notes for each version of
the
framework.
</p>
<p>
- For more detail about a specific class or package, the Struts
+ For more detail about a specific class or package, the Struts
<a href="api/index.html"><b>Javadocs</b></a>
- are <b>surprisingly comprehensive and carefully maintained</b>. It is
<i>strongly</i> recommended that
- you refer to the
+ are <b>surprisingly comprehensive and carefully maintained</b>. It is
<i>strongly</i> recommended that
+ you refer to the
<a href="api/index.html">
- Javadoc</a> for each class as you begin to use it, to be sure important features
+ Javadoc</a> for each class as you begin to use it, to be sure important features
and options are not overlooked. <i>What you don't know, can't help you.</i>
</p>
<p>
- Of course, the only true documentation is the code itself. If you have any
questions
- about how Struts actually works, do not hesitate to <i>use the source</i>. For
the
- complete, buildable source code to the entire Struts framework, see the "src"
folder in
+ Of course, the only true documentation is the code itself. If you have any
questions
+ about how Struts actually works, do not hesitate to <i>use the source</i>. For the
+ complete, buildable source code to the entire Struts framework, see the "src"
folder in
the <a href="http://jakarta.apache.org/builds/jakarta-struts/release/v1.0.2/src/";>
<b>Struts 1.0.2 source distribution</b></a>.
</p>
<p>
- The Struts <a href="#Involved">Mailing Lists</a> are a treasure trove of useful,
- interactive information. The user list tends to carry a high volume, so always
check
- the published documentation and the
+ The Struts <a href="#Involved">Mailing Lists</a> are a treasure trove of useful,
+ interactive information. The user list tends to carry a high volume, so always
check
+ the published documentation and the
<a href="http://nagoya.apache.org/eyebrowse/SummarizeList?listId=42";>
- <b>MAILING LIST ARCHIVE</b></a> before
- <a href="http://www.tuxedo.org/~esr/faqs/smart-questions.html";>posting a new
question</a>.
+ <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/index.html"><b>Resources</b></a> page provides
links to
- everything else published about Struts, including
- <a href="resources/books.html">books</a>,
- <a href="resources/articles.html">articles</a>,
- <a href="resources/tutorials.html">tutorials</a>,
- <a href="resources/seminars.html">seminars</a>,
+ The Struts <a href="resources/index.html"><b>Resources</b></a> page provides
links to
+ everything else published about Struts, including
+ <a href="resources/books.html">books</a>,
+ <a href="resources/articles.html">articles</a>,
+ <a href="resources/tutorials.html">tutorials</a>,
+ <a href="resources/seminars.html">seminars</a>,
and sample applications. There are also links to public sites "Powered by Struts"
and
a directory of professional Struts consultants.
</p>
<p>
- The Struts <a href="news.html"><b>News & Status</b></a> page highlights
current
- events affecting the framework, including new releases, proposals for new
features,
+ The Struts <a href="news.html"><b>News & Status</b></a> page highlights
current
+ events affecting the framework, including new releases, proposals for new
features,
and additions to the Resources page.
</p>
</section>
- <section name="Struts Book Review Project" href="review">
-
- <p>
- The OReilly Struts book (title not set yet) will be available sometime in the 3rd
- quarter of 2002. Published by OReilly, this book is to cover both Struts 1.0 and
1.1.
- The beta or draft chapters are being made
- <a href="http://www.theserverside.com/resources/strutsreview.jsp";><b>available
for
- download</b></a> to facilitate an early public review process for the material.
- </p>
-
- <p>
- Struts has been featured in several published books, and others are slated for
publication.
- See the <a href="resources/books.html">Struts Resources<b>:</b>Books</a> page for
details.
- </p>
-
- </section>
-
<section name="Acquiring Struts" href="Acquiring">
<p>
@@ -191,9 +161,9 @@
<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></li>
</ul>
-
+
<p>
- Check the
+ 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>
@@ -204,7 +174,7 @@
<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
+ 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>.
@@ -229,7 +199,7 @@
</ul>
<p>
- Check the
+ Check the
<a href="http://jakarta.apache.org/struts/userGuide/release-notes-1.1-b2.html";>
Release Notes</a> for a summary of the changes since the Struts 1.0.2 release.
</p>
@@ -240,7 +210,7 @@
<a
href="http://jakarta.apache.org/struts/userGuide/installation.html#Prerequisites";>
prerequisite</a> software applications. Then, follow the appropriate instructions
to
<a href="http://jakarta.apache.org/struts/userGuide/installation.html#Installing";>
- install and use a Struts binary
+ install and use a Struts binary
distribution</a> in your web application or for
<a href="http://jakarta.apache.org/struts/userGuide/installation.html#Building";>
building Struts from the source distribution</a>.
@@ -250,8 +220,8 @@
<section name="Nightly Builds" href="Builds">
<p>
- For developers who are helping to develop Struts, or who just want
- "the latest bits", the latest development version is made available each
+ For developers who are helping to develop Struts, or who just want
+ "the latest bits", the latest development version is made available each
morning. Use at your own risk!
</p>
@@ -268,7 +238,7 @@
</ul>
<p>
- Be sure to check the
+ Be sure to check the
<a href="http://jakarta.apache.org/struts/userGuide/release-notes.html";>
Release Notes</a> for the nightly builds so you know what you are getting!
</p>
@@ -286,15 +256,15 @@
<section name="Reporting Bugs and Feature Requests" href="Bugs">
<p>
- Tracking of bug reports and enhancement requests for Struts is handled
- through the
+ Tracking of bug reports and enhancement requests for Struts is handled
+ through the
<a href="http://jakarta.apache.org/site/bugs.html";>
- 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
+ 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. Please
- be sure to read
- <a href="http://www.chiark.greenend.org.uk/~sgtatham/bugs.html";>How to Report
+ 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>
@@ -304,23 +274,23 @@
<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.
+ 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
+ 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 posted as an enhancement request to
+ New additions for the Resources page should posted as an enhancement request to
<a href="#Bugs">Bugzilla</a>.
</p>
@@ -329,9 +299,9 @@
<section name="Joining the Mailing Lists" href="lists">
<p>
- 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
+ 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>
@@ -349,12 +319,12 @@
[<a href="mailto:[EMAIL PROTECTED]";>Unsubscribe</a>]
</li>
<li><strong>STRUTS-USER Digest</strong> - Subscribe to this list
- to receive a daily digest of the Struts USER list.
+ to receive a daily digest of the Struts USER list.
[<a
href="mailto:[EMAIL PROTECTED]";>Subscribe</a>]
[<a
href="mailto:[EMAIL PROTECTED]";>Unsubscribe</a>]
</li>
- <li><strong>STRUTS-USER Newsgroup</strong> - The User list is also mirrored
online,
- so that you can participate <b>without</b> subscribing to the regular mailing
+ <li><strong>STRUTS-USER Newsgroup</strong> - The User list is also mirrored
online,
+ so that you can participate <b>without</b> subscribing to the regular mailing
list.<br/>
[<a href="http://news.basebeans.com/forums.jsp";>Struts Newsgroup</a>]<br/>
Our thanks to BaseBeans Engineering for providing this much-needed service!
@@ -366,12 +336,12 @@
<section name="Posting a Question to a Mailing List" href="questions">
<p>
- Before posting a new question, be sure to consult the
+ Before posting a new question, be sure to consult the
<a href="http://nagoya.apache.org/eyebrowse/SummarizeList?listId=42";>
<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
+ 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>
@@ -380,9 +350,9 @@
<section name="Getting Involved" href="Involved">
<p>
- All work on Struts and the other Jakarta subprojects is provided on a volunteer
- basis. For more about what you can do, see the
- <a href="http://jakarta.apache.org/site/getinvolved.html";>Getting Involved
+ All work on Struts and the other Jakarta subprojects is provided on 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>
--
To unsubscribe, e-mail: <mailto:[EMAIL PROTECTED]>
For additional commands, e-mail: <mailto:[EMAIL PROTECTED]>
