Author: lukaszlenart
Date: Sun Feb 9 10:11:33 2014
New Revision: 1566260
URL: http://svn.apache.org/r1566260
Log:
Converts kickstart to Markdown and Jekyll
Added:
struts/site/branches/jekyll-powered/content/kickstart.html
struts/site/branches/jekyll-powered/source/kickstart.md
Removed:
struts/site/branches/jekyll-powered/old-content/fml/kickstart.fml
struts/site/branches/jekyll-powered/old-content/fml/roadmap.fml
Added: struts/site/branches/jekyll-powered/content/kickstart.html
URL:
http://svn.apache.org/viewvc/struts/site/branches/jekyll-powered/content/kickstart.html?rev=1566260&view=auto
==============================================================================
--- struts/site/branches/jekyll-powered/content/kickstart.html (added)
+++ struts/site/branches/jekyll-powered/content/kickstart.html Sun Feb 9
10:11:33 2014
@@ -0,0 +1,275 @@
+<!DOCTYPE html>
+<html>
+<head>
+ <meta charset="UTF-8"/>
+ <meta name="viewport" content="width=device-width, initial-scale=1.0"/>
+ <meta name="Date-Revision-yyyymmdd" content="20140206"/>
+ <meta http-equiv="Content-Language" content="en"/>
+ <meta http-equiv="X-UA-Compatible" content="IE=edge,chrome=1">
+
+ <title>Kickstart FAQ</title>
+
+ <link rel="stylesheet" href="/bootstrap/css/bootstrap.css">
+ <link rel="stylesheet" href="/css/main.css">
+
+ <script type="text/javascript" src="/js/jquery-1.11.0.min.js"></script>
+ <script type="text/javascript" src="/bootstrap/js/bootstrap.js"></script>
+ <script type="text/javascript" src="/js/community.js"></script>
+</head>
+<body>
+
+<a href="http://github.com/apache/struts";>
+ <img style="position: absolute; top: 0; right: 0; border: 0; z-index:
10000;"
src="https://s3.amazonaws.com/github/ribbons/forkme_right_red_aa0000.png";
alt="Fork me on GitHub">
+</a>
+
+<header>
+ <!-- Fixed navbar -->
+<nav>
+ <div class="navbar navbar-default navbar-fixed-top" role="navigation">
+ <div class="container">
+ <div class="navbar-collapse collapse">
+ <ul class="nav navbar-nav">
+
+ <li class="dropdown">
+ <a class="dropdown-toggle" data-toggle="dropdown" href="#">Apache
Struts <b class="caret"></b></a>
+ <ul class="dropdown-menu">
+ <li><a href="index.html">Welcome</a></li>
+ <li><a href="downloads.html">Downloads</a></li>
+ <li><a href="announce.html">Announcements</a></li>
+ <li><a href="http://www.apache.org/licenses/";>License</a></li>
+ <li><a
href="http://apache.org/foundation/thanks.html";>Thanks!</a></li>
+ <li><a
href="http://apache.org/foundation/sponsorship.html";>Sponsorship</a></li>
+ </ul>
+ </li>
+
+ <li class="dropdown">
+ <a class="dropdown-toggle" data-toggle="dropdown" href="#">Support
<b class="caret"></b></a>
+ <ul class="dropdown-menu">
+ <li><a href="mail.html">User Mailing List</a></li>
+ <li><a href="https://issues.apache.org/jira/browse/WW";>Issue
Tracker</a></li>
+ <li><a href="security.html">Reporting Security Issues</a></li>
+ </ul>
+ </li>
+
+ <li class="dropdown">
+ <a class="dropdown-toggle" data-toggle="dropdown"
href="#">Documentation <b class="caret"></b></a>
+ <ul class="dropdown-menu">
+ <li><a href="birdseye.html">Birds Eye</a></li>
+ <li><a href="primer.html">Key Technologies</a></li>
+ <li><a href="kickstart.html">Kickstart FAQ</a></li>
+ <li><a
href="https://cwiki.apache.org/confluence/display/WW/Home";>Wiki</a></li>
+ <li><a
href="http://struts.apache.org/release/2.3.x/index.html";>Struts 2</a></li>
+ <li><a
href="http://struts.apache.org/release/1.3.x/index.html";>Struts 1</a></li>
+ </ul>
+ </li>
+
+ <li class="dropdown">
+ <a class="dropdown-toggle" data-toggle="dropdown"
href="#">Contributing <b class="caret"></b></a>
+ <ul class="dropdown-menu">
+ <li><a href="youatstruts.html">You at Struts</a></li>
+ <li><a href="helping.html">How to Help FAQ</a></li>
+ <li><a href="dev-mail.html">Development Lists</a></li>
+ <li class="divider"></li>
+ <li><a href="git-for-struts.html">Git for Struts</a></li>
+ <li><a href="builds.html">Source Code</a></li>
+ <li><a href="coding-standards.html">Coding standards</a></li>
+ <li class="divider"></li>
+ <li><a href="releases.html">Release Guidelines</a></li>
+ <li><a href="bylaws.html">PMC Charter</a></li>
+ <li><a href="volunteers.html">Volunteers</a></li>
+ <li><a
href="https://git-wip-us.apache.org/repos/asf?p=struts.git";>Source
Repository</a></li>
+ </ul>
+ </li>
+
+ </ul>
+ </div>
+ <!--/.nav-collapse -->
+ </div>
+ </div>
+</nav>
+
+ <div class="container">
+ <div class="row">
+ <div class="pull-left">
+ <a href="/" id="bannerLeft">
+ <img src="/img/struts.gif" alt="Apache Struts"/>
+ </a>
+ </div>
+ <div class="pull-right"><a href="http://www.apache.org"; id="bannerRight">
+ <img src="/img/asf-logo.gif" alt="Apache Software Foundation"/>
+ </a>
+ </div>
+ </div>
+ </div>
+</header>
+
+
+<article class="container">
+ <section class="col-md-12">
+ <h1>Kickstart FAQ</h1>
+
+<h2>General</h2>
+
+<ul>
+<li><h3>I'm new to Apache Struts. How do I get started?</h3>
+
+<p>The best place to start is with the "best available" <a
href="downloads.html">release</a>.
+If you are new to Java or web development, as well as Apache Struts, be sure
to review the
+<a href="primer.html">Key Technologies Primer</a>.</p>
+
+<p>The main Struts web site includes documentation for the latest
"General Availability" release
+in each major release series. The development section of the site inclues
draft documentation
+for upcoming releases. If you are just getting started, focus on the latest
General
+Availability release, Documentation for past <a
href="downloads.html">releases</a> is also available.</p>
+
+<p>If you have questions, you can search the <a href="mail.html#archives">User
Mailing List archives</a>,
+or <a href="mail.html">post your own question to the list</a>. (Plain old
Google usually works too!)</p></li>
+<li><h3>Looking at the releases page, some versions seem to be missing. What
happened to them?</h3>
+
+<p>Apache Struts uses a "milestone build" system to create releases.
First, we create a build
+with a milestone version number, like Struts 2.0.42, and post the distribution
in the development area.
+The development group tests the distribution, and then we decide whether or
not to release it.
+The distribution includes everything that would be released, including the
documentation and the release notes
+for this version.</p>
+
+<p>If we find a significant problem with the distribution, we may decide not
to release it, and just leave
+the distribution as a "test build". The testing may take several
days, and in the meantime, we want to keep
+the project moving, and so we just go onto the next version number.
+Using our example, the next distribution would be labeled 2.0.43, even if
version 2.0.42 was never officially
+released.</p>
+
+<p>Often. we will first grade a release as a "beta", and invite
other users to test it too. If this second
+round of beta testing goes well, then we may mark the release "General
Availability".
+Usually, that designation would also make it the new "Best
Available" release. In this case, we don't create
+another distribution, but simply adjust the status of the same set of bits
that people have been testing all along.</p>
+
+<p>In practice, the milestone build system is fast and efficient and creates
the fewest number of "candidate builds"
+between releases.</p></li>
+<li><h3>Why is the project called "Struts"?</h3>
+
+<p>It's a reference to "struts" in the architectural sense, a
reminder of the nearly invisible pieces that hold up
+buildings, houses, and bridges.</p></li>
+<li><h3>How is Apache Struts licensed?</h3>
+
+<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".</p></li>
+<li><h3>Can Apache Struts be used in a commercial product?</h3>
+
+<p>Yes. The only requirements you must meet are those listed in the <a
href="http://www.apache.org/licenses";>Apache License</a>.</p></li>
+<li><h3>Do I have to credit Apache Struts on my own web site?</h3>
+
+<p>You need to credit Apache Struts if you <strong>redistribute your own
framework</strong> based on our products
+for other people to use. (See the <a
href="http://www.apache.org/LICENSE";>Apache License</a> for details.)
+But you do <strong>not</strong> need to credit Apache Struts just because your
web application utilizes one of our products.
+It's the same situation as using the Apache HTTPD server or Tomcat. Not
required if its just running your web site.
+Required if you've used the source code to create your own server that you
are redistributing to other people.</p></li>
+<li><h3>Are there ISPs that will host my Java web application?</h3>
+
+<p>For a listing of some Java and Struts ISPs, visit the <a
href="http://struts.sf.net/community/index.html";>Struts Community Resources</a>
+area on SourceForge.</p></li>
+<li><h3>Is there a particularly good IDE to use?</h3>
+
+<p>The frameworks should work well with any development environment that you
would like to use, as well as with any
+programmers editor. The members of the Apache Struts development group each
use their own tools such as
+<a href="http://www.gnu.org/software/emacs/emacs.html";>Emacs</a>, <a
href="http://www.jetbrains.com/idea/";>IntelliJ IDEA</a>,
+<a href="http://www.eclipse.org/";>Eclipse</a>, and <a
href="http://www.netbeans.org/";>NetBeans</a>.</p>
+
+<p>For more, see the <a
href="http://wiki.apache.org/struts/StrutsMyFavoriteIDE";>IDE discussion
page</a> in the Struts wiki.</p></li>
+</ul>
+
+<h2>Product Support</h2>
+
+<ul>
+<li><h3>Where can I get help with Apache Struts?</h3>
+
+<p>Each release of Struts comes with a User Guide or set of Tutorials to
introduce people to the framework
+and its underlying technologies. Various components also have their own
in-depth Developers Guide, to cover
+more advanced topics. Comprehensive Javadocs are provided for each release,
along with the <strong>full source code</strong>.</p>
+
+<p>The <a href="mail.html">Struts user mailing list</a> is also very active,
and welcomes posts from new users. Before
+posting a new question, be sure to consult the <strong><a
href="mail.html#Archives">MAILING LIST ARCHIVE</a></strong>
+and the very excellent <a
href="http://www.catb.org/%7Eesr/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></li>
+<li><h3>Is commercial support available?</h3>
+
+<p>The Apache Software Foundation does not provide commercial support for any
of our software products,
+including Apache Struts. However, third parties may offer different degrees of
support.</p></li>
+<li><h3>If a product doesn't do what I want, can I request that a feature
be added?</h3>
+
+<p>First, it's important to remember that Apache Struts is an
all-volunteer project. We don't charge anyone
+anything to use Apache Struts products. Committers and other developers work
on Apache Struts products because
+they need to use it with their own applications. If others can use it too,
that's "icing on the cake".
+If you <a href="helping.html">submit a patch</a> for a feature that a
Committer finds useful, then that
+Committer may choose to volunteer his or her time to apply the patch.
+If you just submit an idea without a patch, it is much less likely to be added
(since first someone else has to
+volunteer their time to write the patch).</p>
+
+<p>We are grateful for any patches, and we welcome new ideas, but the best way
to see that something gets added
+to the framework is to do as much of the work as you can, rather than rely on
the "kindness of strangers".
+Worst case, you can apply the patch to your copy of the framework and still
use the feature in your own application.
+(Which is what open source is <em>really</em> all about.)</p></li>
+<li><h3>Is there a press kit for Apache Struts?</h3>
+
+<p>Except for our <a href="announce.html">announcements page</a>, there is not
a formal press or media kit for Apache Struts.
+Queries from the press (and ONLY queries from the press, NOT support questions
or anything else!)
+should go to our media relations address: <a
href="mailto:[email protected]";>[email protected]</a>.</p></li>
+<li><h3>Where can I report a potential security vulnerability?</h3>
+
+<p>If you believe you've found a security vulnerability in Apache Struts,
please contact our security address - any
+emails not relating to security vulnerabilities will be ignored without a
reply (all security related information
+will be kept confidential unless otherwise indicated): <a
href="mailto:[email protected]";>[email protected]</a>.</p></li>
+</ul>
+
+<h2>Mailing Lists</h2>
+
+<ul>
+<li><h3>Is there a digest for the User list?</h3>
+
+<p>Yes. Send a blank message to <a
href="mailto:[email protected]";>[email protected]</a>.</p>
+
+<p>If you are subscribed to the digest, you can also post to the list. Just be
sure to send your post to
+the <a href="mailto:[email protected]";>user list</a> rather than trying
to reply to the digest.</p></li>
+<li><h3>Is there an Apache Struts newsgroup?</h3>
+
+<p>Not a usenet group, but the Apache 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
<code>gmane.comp.jakarta.struts.user</code>
+for the user list.</p></li>
+<li><h3>Why didn't my posting show up on the user list?</h3>
+
+<p>You must be subscribed to the <a
href="mailto:[email protected]";>user list</a> or
+<a href="mailto:[email protected]";>user digest</a>
before posting (or use the
+<a href="http://news.gmane.org";>GMane Newsgroups</a> instead).</p></li>
+<li><h3>Are there separate user lists for Struts 1 and Struts 2?</h3>
+
+<p>No. Each major version has it's own JIRA project, but we share the
mailing lists.</p>
+
+<p>To get the best response to an inquiry, please specify which version of
Struts is being used,
+including the milestone ("Struts 1.2.9", for example). You can also
include the label <strong>[s1]</strong>
+or <strong>[s2]</strong> in the subject line of your post.</p></li>
+<li><h3>How do I unsubscribe from the mailing list?</h3>
+
+<p><strong>From the email account used to subscribe to the list</strong>, send
a blank message to
+<a
href="mailto:[email protected]";>[email protected]</a>.</p>
+
+<p>If you are receiving the digest, you must send a blank email to
+<a
href="mailto:[email protected]";>[email protected]</a>
instead.</p></li>
+</ul>
+
+ </section>
+</article>
+
+ <hr/>
+<footer class="container">
+ <div class="row col-md-12 text-center">
+ Copyright © 2000-2014 <a href="http://www.apache.org/";>The Apache
Software Foundation</a>. All Rights Reserved.
+ </div>
+ <div class="row col-md-12 text-center">
+ Apache Struts, Struts, Apache, the Apache feather logo, and the Apache
Struts
+ project logos are trademarks of The Apache Software Foundation.
+ </div>
+</footer>
+
+
+</body>
+</html>
Added: struts/site/branches/jekyll-powered/source/kickstart.md
URL:
http://svn.apache.org/viewvc/struts/site/branches/jekyll-powered/source/kickstart.md?rev=1566260&view=auto
==============================================================================
--- struts/site/branches/jekyll-powered/source/kickstart.md (added)
+++ struts/site/branches/jekyll-powered/source/kickstart.md Sun Feb 9 10:11:33
2014
@@ -0,0 +1,164 @@
+---
+layout: default
+title: Kickstart FAQ
+---
+
+# Kickstart FAQ
+
+## General
+
+ - ### I'm new to Apache Struts. How do I get started?
+
+ The best place to start is with the "best available"
[release](downloads.html).
+ If you are new to Java or web development, as well as Apache Struts, be sure
to review the
+ [Key Technologies Primer](primer.html).
+
+ The main Struts web site includes documentation for the latest "General
Availability" release
+ in each major release series. The development section of the site inclues
draft documentation
+ for upcoming releases. If you are just getting started, focus on the latest
General
+ Availability release, Documentation for past [releases](downloads.html) is
also available.
+
+ If you have questions, you can search the [User Mailing List
archives](mail.html#archives),
+ or [post your own question to the list](mail.html). (Plain old Google
usually works too!)
+
+ - ### Looking at the releases page, some versions seem to be missing. What
happened to them?
+
+ Apache Struts uses a "milestone build" system to create releases. First, we
create a build
+ with a milestone version number, like Struts 2.0.42, and post the
distribution in the development area.
+ The development group tests the distribution, and then we decide whether or
not to release it.
+ The distribution includes everything that would be released, including the
documentation and the release notes
+ for this version.
+
+ If we find a significant problem with the distribution, we may decide not to
release it, and just leave
+ the distribution as a "test build". The testing may take several days, and
in the meantime, we want to keep
+ the project moving, and so we just go onto the next version number.
+ Using our example, the next distribution would be labeled 2.0.43, even if
version 2.0.42 was never officially
+ released.
+
+ Often. we will first grade a release as a "beta", and invite other users to
test it too. If this second
+ round of beta testing goes well, then we may mark the release "General
Availability".
+ Usually, that designation would also make it the new "Best Available"
release. In this case, we don't create
+ another distribution, but simply adjust the status of the same set of bits
that people have been testing all along.
+
+ In practice, the milestone build system is fast and efficient and creates
the fewest number of "candidate builds"
+ between releases.
+
+ - ### Why is the project called "Struts"?
+
+ It's a reference to "struts" in the architectural sense, a reminder of the
nearly invisible pieces that hold up
+ buildings, houses, and bridges.
+
+ - ### How is Apache Struts licensed?
+
+ All Apache Struts products are copyrighted software available under the
[Apache License](http://www.apache.org/licenses),
+ a "free-to-use, business-friendly license".
+
+ - ### Can Apache Struts be used in a commercial product?
+
+ Yes. The only requirements you must meet are those listed in the [Apache
License](http://www.apache.org/licenses).
+
+ - ### Do I have to credit Apache Struts on my own web site?
+
+ You need to credit Apache Struts if you **redistribute your own framework**
based on our products
+ for other people to use. (See the [Apache
License](http://www.apache.org/LICENSE) for details.)
+ But you do **not** need to credit Apache Struts just because your web
application utilizes one of our products.
+ It's the same situation as using the Apache HTTPD server or Tomcat. Not
required if its just running your web site.
+ Required if you've used the source code to create your own server that you
are redistributing to other people.
+
+ - ### Are there ISPs that will host my Java web application?
+
+ For a listing of some Java and Struts ISPs, visit the [Struts Community
Resources](http://struts.sf.net/community/index.html)
+ area on SourceForge.
+
+ - ### Is there a particularly good IDE to use?
+
+ The frameworks should work well with any development environment that you
would like to use, as well as with any
+ programmers editor. The members of the Apache Struts development group each
use their own tools such as
+ [Emacs](http://www.gnu.org/software/emacs/emacs.html), [IntelliJ
IDEA](http://www.jetbrains.com/idea/),
+ [Eclipse](http://www.eclipse.org/), and [NetBeans](http://www.netbeans.org/).
+
+ For more, see the [IDE discussion
page](http://wiki.apache.org/struts/StrutsMyFavoriteIDE) in the Struts wiki.
+
+## Product Support
+
+ - ### Where can I get help with Apache Struts?
+
+ Each release of Struts comes with a User Guide or set of Tutorials to
introduce people to the framework
+ and its underlying technologies. Various components also have their own
in-depth Developers Guide, to cover
+ more advanced topics. Comprehensive Javadocs are provided for each release,
along with the **full source code**.
+
+ The [Struts user mailing list](mail.html) is also very active, and welcomes
posts from new users. Before
+ posting a new question, be sure to consult the **[MAILING LIST
ARCHIVE](mail.html#Archives)**
+ and the very excellent [How To Ask Questions The Smart
Way](http://www.catb.org/~esr/faqs/smart-questions.html)
+ by Eric Raymond. Please do be sure to [turn off
HTML](http://expita.com/nomime.html) in your
+ email client before posting.
+
+ - ### Is commercial support available?
+
+ The Apache Software Foundation does not provide commercial support for any
of our software products,
+ including Apache Struts. However, third parties may offer different degrees
of support.
+
+ - ### If a product doesn't do what I want, can I request that a feature be
added?
+
+ First, it's important to remember that Apache Struts is an all-volunteer
project. We don't charge anyone
+ anything to use Apache Struts products. Committers and other developers work
on Apache Struts products because
+ they need to use it with their own applications. If others can use it too,
that's "icing on the cake".
+ If you [submit a patch](helping.html) for a feature that a Committer finds
useful, then that
+ Committer may choose to volunteer his or her time to apply the patch.
+ If you just submit an idea without a patch, it is much less likely to be
added (since first someone else has to
+ volunteer their time to write the patch).
+
+ We are grateful for any patches, and we welcome new ideas, but the best way
to see that something gets added
+ to the framework is to do as much of the work as you can, rather than rely
on the "kindness of strangers".
+ Worst case, you can apply the patch to your copy of the framework and still
use the feature in your own application.
+ (Which is what open source is *really* all about.)
+
+ - ### Is there a press kit for Apache Struts?
+
+ Except for our [announcements page](announce.html), there is not a formal
press or media kit for Apache Struts.
+ Queries from the press (and ONLY queries from the press, NOT support
questions or anything else!)
+ should go to our media relations address:
[[email protected]](mailto:[email protected]).
+
+ - ### Where can I report a potential security vulnerability?
+
+ If you believe you've found a security vulnerability in Apache Struts,
please contact our security address - any
+ emails not relating to security vulnerabilities will be ignored without a
reply (all security related information
+ will be kept confidential unless otherwise indicated):
[[email protected]](mailto:[email protected]).
+
+## Mailing Lists
+
+ - ### Is there a digest for the User list?
+
+ Yes. Send a blank message to
[[email protected]](mailto:[email protected]).
+
+ If you are subscribed to the digest, you can also post to the list. Just be
sure to send your post to
+ the [user list](mailto:[email protected]) rather than trying to reply
to the digest.
+
+ - ### Is there an Apache Struts newsgroup?
+
+ Not a usenet group, but the Apache Struts User list can be accessed with
your favorite newsgroup reader from
+ the [GMane News Site](http://news.gmane.org/). Subscribe to groups
`gmane.comp.jakarta.struts.user`
+ for the user list.
+
+ - ### Why didn't my posting show up on the user list?
+
+ You must be subscribed to the [user
list](mailto:[email protected]) or
+ [user digest](mailto:[email protected]) before posting
(or use the
+ [GMane Newsgroups](http://news.gmane.org) instead).
+
+
+ - ### Are there separate user lists for Struts 1 and Struts 2?
+
+ No. Each major version has it's own JIRA project, but we share the mailing
lists.
+
+ To get the best response to an inquiry, please specify which version of
Struts is being used,
+ including the milestone ("Struts 1.2.9", for example). You can also include
the label **\[s1]**
+ or **\[s2]** in the subject line of your post.
+
+ - ### How do I unsubscribe from the mailing list?
+
+ **From the email account used to subscribe to the list**, send a blank
message to
+
[[email protected]](mailto:[email protected]).
+
+ If you are receiving the digest, you must send a blank email to
+
[[email protected]](mailto:[email protected])
instead.
![https://s3.amazonaws.com/github/ribbons/forkme_right_red_aa0000.png"](https://s3.amazonaws.com/github/ribbons/forkme_right_red_aa0000.png"){kind=link}