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/19 17:15:53 UTC
svn commit: r378917 - in /struts/site/trunk/xdocs: helping.fml index.xml
kickstart.fml
Author: husted
Date: Sun Feb 19 08:15:52 2006
New Revision: 378917
URL: http://svn.apache.org/viewcvs?rev=378917&view=rev
Log:
Kickstart, Helping, and Welcome
* Tweaks and typos.
Modified:
struts/site/trunk/xdocs/helping.fml
struts/site/trunk/xdocs/index.xml
struts/site/trunk/xdocs/kickstart.fml
Modified: struts/site/trunk/xdocs/helping.fml
URL: http://svn.apache.org/viewcvs/struts/site/trunk/xdocs/helping.fml?rev=378917&r1=378916&r2=378917&view=diff
==============================================================================
--- struts/site/trunk/xdocs/helping.fml (original)
+++ struts/site/trunk/xdocs/helping.fml Sun Feb 19 08:15:52 2006
@@ -123,13 +123,11 @@
<p>
Before joining any Apache mailing list, please be sure to
read the
- <a href="mail.html#Guidelines">Mailing List Guidelines</a>
- .
+ <a href="mail.html#Guidelines">Mailing List Guidelines.</a>
If you have read and understood these guidelines, you are
welcome to
<a href="mail.html#Subscribing">join the Struts mailing
- lists</a>
- .
+ lists.</a>
</p>
<p>
@@ -179,8 +177,7 @@
<a href="#patches">patch</a>
or unit test,
and
- <a href="#contribute">add the patch or test</a>
- .
+ <a href="#contribute">add the patch or test.</a>
Please note that we do not use @author tags in our
JavaDocs and
documentation.
@@ -200,11 +197,9 @@
it's up to you to step up with the tests and fixes that
get a release out
the door.
- (
<a href="http://jakarta.apache.org/site/contributing.html">
- Like Craig
- McClanahan did for Tomcat.</a>
- )
+ (Like Craig
+ McClanahan did for Tomcat.)</a>
</p>
<p>
@@ -212,8 +207,7 @@
involved by turning your
war stories into FAQs and how-tos that we can make part of
the
- <a href="#documentation">documentation</a>
- .
+ <a href="#documentation">documentation.</a>
The mailing list is very active and
trundling through the archives is no picnic.
We can always use volunteers who can reduce the best
@@ -340,9 +334,8 @@
How to Report Bugs Effectively</a>
and report it to
<a href="http://issues.apache.org/bugzilla">
- <strong>Bugzilla</strong>
+ <strong>Bugzilla.</strong>
</a>
- .
</p>
<p>
@@ -375,8 +368,7 @@
<p>
Feature suggestions are also maintained in the
<a href="http://issues.apache.org/bugzilla">Bugzilla
- database</a>
- .
+ database.</a>
</p>
<p>
@@ -608,8 +600,7 @@
<p>
You can also post documentation to the
- <a href="wiki.apache.org/struts/">Struts Wiki</a>
- .
+ <a href="wiki.apache.org/struts/">Struts Wiki.</a>
</p>
</answer>
</faq>
@@ -714,8 +705,7 @@
and test it against your own applications.
Report any and all issues or suspected issues to
<a href="http://issues.apache.org/bugzilla">
- Bugzilla</a>
- .
+ Bugzilla.</a>
The sooner we resolve any problems, the fewer
betas or
release candidates
@@ -728,9 +718,8 @@
<li>
<strong>Contribute
- <a href="kickstart.html#tests">unit tests</a>
+ <a href="kickstart.html#tests">unit tests.</a>
</strong>
- .
The closer we get to a release, the more we worry
about breaking something.
The more tests we have, the more confident we can
@@ -749,8 +738,7 @@
<li>
<strong>Review the list of issues</strong>
at
- <a href="#bugs">Bugzilla</a>
- .
+ <a href="#bugs">Bugzilla.</a>
If there are any to which you can respond, please
do.
If there any patches posted, feel free to test
@@ -762,8 +750,7 @@
<li>
<strong>Confirm an issue's category and
- status</strong>
- .
+ status.</strong>
Newbies often post feature suggestions or
help-desk
questions as "bugs".
@@ -866,26 +853,23 @@
development discussions.
If the PMC vote passes, we will send the developer a
invitation
- privately, to give the individaul a chance to accept or
+ privately, to give the individual a chance to accept or
discretely
decline.
- If the candidate accepts,
+ If the candidate is able to accept,
the PMC will announce the new member on the dev list.
</p>
<p>
For more about decision-making, see
- "
<a href="http://apache.org/foundation/how-it-works.html">
- How the ASF Works</a>
- " and the
- <a href="bylaws.html">Apache Struts Charter</a>
- .
+ "How the ASF Works"</a>
+ and the
+ <a href="bylaws.html">Apache Struts Charter.</a>
For more about project infrastructure,
see "Project Maintenance and Resources" in the
<a href="http://wiki.apache.org/struts/">Apache Struts
- wiki</a>
- .
+ wiki.</a>
</p>
</answer>
Modified: struts/site/trunk/xdocs/index.xml
URL: http://svn.apache.org/viewcvs/struts/site/trunk/xdocs/index.xml?rev=378917&r1=378916&r2=378917&view=diff
==============================================================================
--- struts/site/trunk/xdocs/index.xml (original)
+++ struts/site/trunk/xdocs/index.xml Sun Feb 19 08:15:52 2006
@@ -56,13 +56,11 @@
and several other subprojects.
The two frameworks are the
<strong>Struts Action Framework</strong>
- and
- the
+ and the
<strong>Struts Shale Framework</strong>
.
Struts Action is the original request-based framework.
- Struts Shale is a component-based framework based on
- JavaServer Faces.
+ Struts Shale is a component-based framework for JavaServer Faces.
Both frameworks are first-class citizens of the Apache Struts
project.
</p>
@@ -72,9 +70,8 @@
<p>
When
<a href="http://java.sun.com/j2ee/javaserverfaces/">
- JavaServer Faces arrived</a>
- ,
- our development community chose to "make new friends but
+ JavaServer Faces</a>
+ arrived, our development community chose to "make new friends but
keep the old".
Some of us want to stick with a request-based framework.
Others are ready to switch to a component-based framework
@@ -92,11 +89,13 @@
</p>
<p>
- If you are starting a new project using new technology,
+ If you are starting a new project want to use the latest
+ technology,
don't worry, we are still blazing trails, same as ever.
- For new JavaServer Faces project, we offer the Shale
+ For projects using JavaServer Faces, we offer the Shale
Framework.
- For new JSP projects, we offer the original Action framework.
+ For projects using JSP and templating technologies, we offer the
+ original Action framework.
Soon, we will also offer a new Action 2 framework, based on
<a href="announce.html#a20051214.3">WebWork</a>
technology.
@@ -111,8 +110,7 @@
<p>
For more about how Action and Shale fit together,
see our
- <a href="kickstart.html">KickStart FAQ</a>
- .
+ <a href="kickstart.html">KickStart FAQ.</a>
</p>
</subsection>
@@ -133,12 +131,11 @@
</p>
<p>
The subprojects will be distributed as part of the Struts
- Action 1.3.x release series.
- The initial 1.3.0 release is still under development.
+ Action 1.3 release series.
+ The initial 1.3 releases are still under development.
Right now,
<a href="http://struts.apache.org/downloads.html">
- Struts 1.2.8 is the best available release</a>
- .
+ Struts 1.2.8 is the best available release.</a>
</p>
</subsection>
@@ -162,14 +159,12 @@
<li>
Struts is a project of the
<a href="http://www.apache.org">
- The Apache Software Foundation</a>
- .
+ The Apache Software Foundation.</a>
</li>
<li>
The official Apache Struts home page is at
<a href="http://struts.apache.org/">
- http://struts.apache.org/</a>
- .
+ http://struts.apache.org/.</a>
</li>
</ul>
</subsection>
Modified: struts/site/trunk/xdocs/kickstart.fml
URL: http://svn.apache.org/viewcvs/struts/site/trunk/xdocs/kickstart.fml?rev=378917&r1=378916&r2=378917&view=diff
==============================================================================
--- struts/site/trunk/xdocs/kickstart.fml (original)
+++ struts/site/trunk/xdocs/kickstart.fml Sun Feb 19 08:15:52 2006
@@ -141,8 +141,7 @@
Framework. All are welcome.</p>
<p>For more about volunteering, visit our
<a href="http://struts.apache.org/faqs/helping.html">how
- to help page</a>
- .
+ to help page.</a>
</p>
</answer>
</faq>
@@ -222,8 +221,7 @@
<p>
WebWork started as a
<a href="http://incubator.apache.org/learn/rules-for-revolutionaries.html">
- Struts Revolution</a>
- .
+ Struts Revolution.</a>
Over the years, it has evolved into a superb action-based
framework that retains many Struts 1.x paradigms.
</p>
@@ -340,7 +338,8 @@
<p>
Conventional JSP is a tried and true strategy.
When used as part of a MVC architecture, applications based on
- server pages are easy to create, maintain, and extend over time.
+ server pages or templates are known to be easy to create,
+ maintain, and extend over time.
</p>
<p>
If you are a sole developer working on a small application,
@@ -349,10 +348,10 @@
<a href="http://java.sun.com/products/jsp/jstl/index.jsp">
JSTL</a>
"out of the box."
- If you choose JSF, be sure to give
+ (If you choose JSF, be sure to give
<a href="http://developers.sun.com/prodtech/javatools/jscreator/">
Java Studio Creator</a>
- a try.
+ a try.)
</p>
<p>
Multi-developer teams working on larger applications will
@@ -364,8 +363,7 @@
or
<a href="http://struts.apache.org/struts-action/index.html">
Struts Action</a>
- for JSP
- .
+ for JSP.
</p>
</answer>
</faq>
@@ -406,8 +404,8 @@
<p>
Lest we forget: Someone also needs to choose a database system
- (DB2? Derby? Oracle? MySQL?), a version control system (CVS?
- Subversion? Perforce?),
+ (DB2? Derby? Oracle? PostGres? MySQL?), a version control system
+ (CVS? Subversion? Perforce?),
a development methodology (eXtreme Programming? RUP? Scrum?
Waterfall?),
and, if you're lucky, an issue tracker (Bugzilla? JIRA? Scarab?).
@@ -434,8 +432,7 @@
If you'd like a head-start on Action 2,
you could start new development with WebWork 2 today.
<a href="announce.html#a20051214.3">
- WebWork is joining Apache Struts</a>
- ,
+ WebWork is joining Apache Struts,</a>
and Action 2 will be an updated release of WebWork 2.2.
Undoubtedly, there will be some changes,
but the core API and architecture will remain the same.
@@ -448,7 +445,7 @@
and help reduce choice for the rest of us?</question>
<answer>
<p>
- Apache Struts is neither a steering committer nor a vendor. We're
+ Apache Struts is neither a steering committee nor a vendor. We're
a group of engineers creating the web application frameworks that
we want to use to build our own applications. Some of us are
working on JSF applications, some of us are working on JSP
@@ -456,9 +453,10 @@
volunteers to work on two frameworks, we offer two
frameworks.</p>
- <p>The Struts committers all work for different employers all over
- the world, and it's not possible for us to say this technology or
- that technology is the only one anyone in our group can use.
+ <p>The Struts committers work for different employers all over
+ the world. It is not feasible for us to say this technology or
+ that technology is the only technology anyone in our group can
+ use.
One of our employers might choose JSF, and another might stick
with JSP. We are a working group of engineers who live in the
real world, and we are faced with all the same choices every Java
@@ -476,8 +474,7 @@
glad we could help. If you'd like to help us make the frameworks
even better, feel free to return the favor. We don't want your
money, but
- <a href="helping.html">we could use your help</a>
- .
+ <a href="helping.html">we could use your help.</a>
</p>
</answer>
</faq>
@@ -501,8 +498,8 @@
<p>All Apache Struts products are copyrighted software
available under the
<a href="http://www.apache.org/licenses">Apache
- License</a>
- , a "free-to-use, business-friendly license".
+ License,</a>
+ a "free-to-use, business-friendly license".
</p>
</answer>
</faq>
@@ -514,8 +511,7 @@
<p>Yes. The only requirements you must meet are those listed
in the
<a href="http://www.apache.org/licenses">Apache
- License</a>
- .
+ License.</a>
</p>
</answer>
</faq>
@@ -650,15 +646,11 @@
The members of the Struts development team each use their
own tools such as
<a href="http://www.gnu.org/software/emacs/emacs.html">
- Emacs</a>
- ,
- <a href="http://www.intellij.com/idea/">IDEA</a>
- ,
- <a href="http://www.eclipse.org/">Eclipse</a>
- ,
+ Emacs,</a>
+ <a href="http://www.intellij.com/idea/">IDEA,</a>
+ <a href="http://www.eclipse.org/">Eclipse,</a>
and
- <a href="http://www.netbeans.org/">NetBeans</a>
- .
+ <a href="http://www.netbeans.org/">NetBeans.</a>
</p>
<p>
See the
@@ -697,8 +689,8 @@
Not a usenet group, but the Struts User list can be
accessed with your
favorite newsgroup reader from the
- <a href="http://news.gmane.org/">GMane News Site</a>
- . Subscribe to groups
+ <a href="http://news.gmane.org/">GMane News Site.</a>
+ Subscribe to groups
<code>gmane.comp.jakarta.struts.devel</code>
for the developer list, or
<code>gmane.comp.jakarta.struts.user</code>
---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@struts.apache.org
For additional commands, e-mail: dev-help@struts.apache.org