<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en">
<head>
<title>Using - The Apache Struts Web Application Framework</title>
<meta content="text/html; charset=utf-8" http-equiv="Content-Type" />
<meta content="Craig R. McClanahan" name="author" />
<meta content="Ted Husted" name="author" />
<meta content="Martin Cooper" name="author" />
<meta content="James Holmes" name="author" />
<link href="./struts.css" type="text/css" rel="stylesheet" />
</head>
<body>
<div id="heading">
<a href="http://apache.org/">
<img id="asf_logo_wide" alt="The Apache Project" src="./images/asf_logo_wide.gif" />
</a>
<a href="http://struts.apache.org/">
<img id="struts-logo" alt="Struts Framework" src="./images/struts.gif" />
</a>
</div>
<!--end heading-->
<div id="content">
<div id="menu">
<p>Struts</p>
<ul>
<li>
<a href="index.html">Welcome</a>
</li>
<li>
<a href="learning.html">Learning</a>
</li>
<li>
<a href="acquiring.html">Acquiring</a>
</li>
<li>
<a href="using.html">Using</a>
</li>
<li>
<a href="volunteers.html">Who We Are</a>
</li>
<li>
<a href="announce.html">Announcements</a>
</li>
</ul>
<p>Documentation</p>
<ul>
<li>
<a href="userGuide/index.html">User and Developer Guides</a>
</li>
<li>
<a href="userGuide/release-notes.html">Release Notes</a>
</li>
<li>
<a href="api/index.html">Javadoc</a>
</li>
<li>
<a href="faqs/index.html">FAQs and Howtos</a>
</li>
</ul>
<p>Community</p>
<ul>
<li>
<a href="http://jakarta.apache.org/site/bugs.html">Known Issues (Bugzilla)</a>
</li>
<li>
<a href="http://wiki.apache.org/struts">Wiki Pages</a>
</li>
<li>
<a href="http://mail-archives.apache.org/eyebrowse/SummarizeList?listId=241">List Archive</a>
</li>
<li>
<a href="http://wiki.apache.org/struts/StrutsResources">Resource Directory</a>
</li>
</ul>
<p>Download</p>
<ul>
<li>
<a href="http://struts.apache.org/download.cgi">Binaries</a>
</li>
<li>
<a href="http://struts.apache.org/download.cgi">Source Code</a>
</li>
<li>
<a href="http://svn.apache.org/dist/struts/">Development Releases</a>
</li>
</ul>
<p>Development</p>
<ul>
<li>
<a href="bylaws.html">Bylaws</a>
</li>
<li>
<a href="releases.html">Release Guidelines</a>
</li>
<li>
<a href="roadmap.html">Roadmap</a>
</li>
<li>
<a href="http://svn.apache.org/viewcvs.cgi/struts/action/branches/STRUTS_1_2_BRANCH/">Source Repository</a>
</li>
</ul>
</div>
<!--end menu-->
<div id="main">
<h2>Using Struts</h2>
<div class="indent">
<p>
In the normal course of using an application framework like Struts,
you may wish to
</p>
<ul>
<li>
<a href="#Bugs">report a bug or feature request</a>,
</li>
<li>
<a href="#Patches">contribute a patch</a>,
</li>
<li>
<a href="#Lists">join the mailing lists</a>,
</li>
<li>
<a href="#Questions">post a question</a>,
</li>
<li>
or otherwise <a href="#Involved">become involved</a> with the Struts
Community.
</li>
</ul>
</div>
<h2 id="Bugs">Reporting Bugs and Feature Requests</h2>
<div class="indent">
<p>
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
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 Bugs Effectively</a> before posting.
</p>
</div>
<h2 id="Patches">Contributing Patches to Code or Documentation</h2>
<div class="indent">
<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>.
<strong>After creating the ticket</strong>, 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
repository 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>
If you have comments on existing material, you can make comments via the Struts Wiki. Just follow the
"Comments?" link on any page.
If you are making a substantial contribution, such as a new HOW-TO, please consider submitting a document in
the XML format we use.
This will make it easier to add your contribution to the official documentation so that it becomes part of the
WAR distributed with Struts.
</p>
<p>
For more, see the <a href="./faqs/helping.html">How to Help FAQ</a>.
</p>
</div>
<h2 id="Lists">Joining the Mailing Lists</h2>
<div class="indent">
<p>
Before joining any Apache mailing list, please be sure to read the
<a href="mail.html">Mailing List Guidelines</a>.
If you have read and understood these guidelines, you are welcome to
<a href="mail.html">join the Struts mailing lists</a>.
</p>
</div>
<h2 id="Questions">Posting a Question to a Mailing List</h2>
<div class="indent">
<p>
Before posting a new question, be sure to consult the
<a href="http://nagoya.apache.org/eyebrowse/SummarizeList?listId=41">
<strong>MAILING LIST ARCHIVE</strong>
</a> and the very excellent
<a href="http://www.catb.org/~esr/faqs/smart-questions.html">
How To Ask Questions The Smart Way</a> by Eric Raymond.
</p>
<p>
Please do be sure to <a href="http://expita.com/nomime.html">turn off HTML</a> in your email client before posting.
</p>
</div>
<h2 id="Involved">Getting Involved</h2>
<div class="indent">
<p>
All work on Struts (and other Apache projects) is provided on an all-volunteer basis.
For more about what you can do, see the Apache Jakarta
<a href="http://jakarta.apache.org/site/getinvolved.html">Getting Involved Overview</a> and the Struts
<a href="./faqs/helping.html">How to Help FAQ</a>.
</p>
</div>
<hr class="section" />
<div class="indent">
<p class="right">
<strong>Next:</strong> <a href="volunteers.html">Who We Are</a>
</p>
</div>
</div>
<!--end main-->
</div>
<!--end content-->
<div id="footer">
<img id="powered-logo" alt="Powered by Struts" src="./images/struts-power.gif" />
Copyright (c) 2000-2005, The Apache Software Foundation <span class="noprint">-
<a href="http://wiki.apache.org/struts/StrutsDocComments">Comments?</a>
</span>
</div>
<!--end footer-->
</body>
</html>
