geirm 2003/08/07 08:13:31
Modified: src/documentation/content/xdocs/projects geronimo.xml
Log:
Update to try and provide more info immediately to new people showing up
Revision Changes Path
1.6 +237 -14
incubator-site/src/documentation/content/xdocs/projects/geronimo.xml
Index: geronimo.xml
===================================================================
RCS file:
/home/cvs/incubator-site/src/documentation/content/xdocs/projects/geronimo.xml,v
retrieving revision 1.5
retrieving revision 1.6
diff -u -r1.5 -r1.6
--- geronimo.xml 6 Aug 2003 23:57:55 -0000 1.5
+++ geronimo.xml 7 Aug 2003 15:13:31 -0000 1.6
@@ -16,14 +16,50 @@
Apache Geronimo is a new effort coordinated by the Apache Software
Foundation to make a
J2EE compatible container.
</p>
+
+ <p>
+ For more information, please read the latest snapshot of the <link
href="#FAQ">FAQ</link> below
+ or look <link
href="http://nagoya.apache.org/wiki/apachewiki.cgi?ApacheJ2EE/FAQ";>here</link>
for the live one.
+ </p>
+
</section>
<section>
<title>How do I get Involved?</title>
+
+ <p>
+ <strong>Quick Summary</strong>
+ </p>
+
+ <ul>
+ <li>
+ Subscribe to the <link href="#Mailing+Lists">mail lists</link>
+ </li>
+ <li>
+ Download code and materials from <link
href="#Where+is+the+source+and+download%3F">CVS</link>
+ </li>
+ <li>
+ Read the <link href="#FAQ">FAQ</link>
+ </li>
+ <li>
+ Participate and contribute!
+ </li>
+ </ul>
+
+ <p>
+ The most important step is to join the <link
href="#Mailing+Lists">mailing list</link>
+ - please don't post a
+ "How do I get involved?" message, or ask someone to send you more
information.
+ We get far too many requests to be able to do that.
+ </p>
+
<p>
- As with all Apache projects, the usual form is to get the
+ As with all <link href="http://www.apache.org/";>Apache</link>
projects, the usual form is to get the
project's source via CVS tools, join the mailing list(s), find
something to do, and submit a patch to the mailing list for
- their approval and application. We assume that patch donators
+ their approval and application.
+ </p>
+ <p>
+ We assume that patch donators
are familiar with CVS, diff and patch. Enthusiasts are
encouraged to follow the above route rather than apply to
various mailing lists with a "how do I sign up" posting.
@@ -32,26 +68,31 @@
<section>
<title>Mailing Lists</title>
<p>
- Apache Geronimo has two mailing lists of interest:
- </p>
- <ul>
- <li><link
href="mailto:[email protected]";>[email protected]</link></li>
- <li><link
href="mailto:[email protected]";>[email protected]</link></li>
- </ul>
- <p>
- The geronimo-dev mailing list is where all the discussion
- occurs. The geronimo-cvs mailing list receives commit mails
- each time a commit is made to the incubator-geronimo CVS
- module.
+ Apache Geronimo has two mailing lists of interest, the
+ geronimo-dev list, where all the discussion
+ occurs, and the geronimo-cvs list, which receives commit mails each
+ time a commit is made to the incubator-geronimo <link
href="#Where+is+the+source+and+download%3F">CVS</link> module.
+
</p>
+
<p>
You can subscribe to the mailing lists by sending an email to
- one or both of the following addresses:
+ one or both of the following addresses :
</p>
<ul>
<li><link href="mailto:[EMAIL PROTECTED]">[EMAIL
PROTECTED]</link></li>
<li><link href="mailto:[EMAIL PROTECTED]">[EMAIL
PROTECTED]</link></li>
</ul>
+
+ <p>
+ To send a message without subscribing, try the following links.
<strong>However</strong>
+ please don't send a message to the list asking for help,
information or ideas on
+ what to do. The odds are that no one will respond.
+ </p>
+ <ul>
+ <li><link
href="mailto:[email protected]";>[email protected]</link></li>
+ <li><link
href="mailto:[email protected]";>[email protected]</link></li>
+ </ul>
</section>
<section>
<title>Where is the source and download?</title>
@@ -80,6 +121,188 @@
The code can be browsed through ViewCVS at
<link
href="http://cvs.apache.org/viewcvs/incubator-geronimo/";>http://cvs.apache.org/viewcvs/incubator-geronimo/</link>.
</p>
+ </section>
+
+ <section>
+ <title>FAQ</title>
+
+<note>
+ Updated : 2003-08-07 1500 GMT
+</note>
+
+<note>
+The following is a snapshot from the FAQ on the Apache Wiki. It's here for
your convenience, but may be out of date at any moment.
+For the
+updated FAQ, please go <link
href="http://nagoya.apache.org/wiki/apachewiki.cgi?ApacheJ2EE/FAQ";>here</link>.
+</note>
+
+<p>
+These are questions that have come up on the mailing list so far. They are
unofficial, but are best efforts by community members to record useful answers.
+</p>
+<p>
+Some questions are unanswered as yet. Have an answer? Please discuss it on
the mailing list, and record the conclusion here.
+</p>
+<p>
+<strong>Q: I'd like to find out more and help etc. What do I do
next?</strong>
+</p>
+<p>
+A: Participation on the project is via the mailing list and the source code
repository. You join by joining the mailing list, and by participating in
discussion. You help by contributing your ideas, enthusiasm, code,
documentation, tests, and intangibles.
+</p>
+<p>
+The fundamental tenet of the ASF is that Great Communities build great code.
The emphasis is on Community; the code comes from that. If you want to help,
just join the mailing list, see what needs to be done, and do it.
+</p>
+<p>
+Welcome. :-)
+</p>
+<p>
+<strong>Q: Where is the mailing list? How do I subscribe?</strong>
+</p>
+<p>
+A: The mailing list is [EMAIL PROTECTED] You subscribe by sending e-mail to
<link href="mailto:[EMAIL PROTECTED]">[EMAIL PROTECTED]</link>.
+</p>
+<p>
+<strong>Q: Is there an archive?</strong>
+</p>
+<p>
+A: <link
href="http://nagoya.apache.org/eyebrowse/SummarizeList?listId=140";>[Apache J2EE
Archives]</link>
+</p>
+<p>
+<strong>Q: Can you mail me if you're interested in me helping.</strong>
+</p>
+<p>
+A: That's not how open source communities generally work. To the people who
have asked to be contacted if Apache are interested, it's unlikely that this
will happen with all the huge interest that this has generated. Better to stay
in touch with the mailing list.
+</p>
+<p>
+<strong>Q: Where is the Apache CVS module</strong>
+</p>
+<p>
+A: incubator-geronimo <link
href="http://cvs.apache.org/viewcvs/incubator-geronimo";>[Browse CVS]</link>
+</p>
+<p>
+<strong>Q: The CVS module is empty, is there an issue</strong>
+</p>
+<p>
+A: No. The initial committers have not publicly released the base code. Be
patient.
+</p>
+<p>
+<strong>Q: Will it involve JBoss code.</strong>
+</p>
+<p>
+A: No.
+</p>
+<p>
+This is a new Apache project, running under Apache guidelines. The Apache
Software Foundation accepts only voluntary contributions of material from
authors who possess the legal right to donate it.
+</p>
+<p>
+<strong>Q: Will it <insert some technical phrase here>?</strong>
+</p>
+<p>
+A: It's probably worth holding these questions off for the moment. This
project is bringing together members and contributions from many existing J2EE
communities, and is just starting to come together.
+</p>
+<p>
+<strong>Q: What are the rules for Geronimo?</strong>
+</p>
+<p>
+A: See the <link href="http://incubator.apache.org/";>[Apache
Incubator]</link> web site.
+</p>
+<p>
+<strong>Q: What's the website?</strong>
+</p>
+<p>
+A: <link href="http://incubator.apache.org/projects/geronimo.html";>[Apache
J2EE Project]</link>
+</p>
+<p>
+<strong>Q: What tools do I need to learn?</strong>
+</p>
+<p>
+A: CVS. patch. Using a mail list.
+</p>
+<p>
+<strong>Q: Relationship to JBoss and in particular, the JBoss source
base.</strong>
+</p>
+<p>
+A: Several (former) JBoss committers are Geronimo committers. The JBoss
codebase cannot, and will not, be used, at all (it is LGPL).
+</p>
+<p>
+<strong>Q: Does Geronimo replace Tomcat, JSTL etc.</strong>
+</p>
+<p>
+A: No. Geronimo includes other services like Tomcat or Jetty for the web
container, OpenJMS for the JMS, Tyrex for the transaction manager etc. So
Geroimo focusses on being the J2EE container allowing other services to drop in
via JMX.
+</p>
+<p>
+<strong>Q: What other projects will Geronimo reuse?</strong>
+</p>
+<p>
+A: We suspect in the grand scheme of things to reuse various existing open
source projects. Anything which has a suitable BSD / ASF licence is up for
grabs. e.g. the following is a likely list of the things well be using (though
in no way is this definitive)...
+</p>
+<p>
+From the ASF licenced projects...
+</p>
+
+<ul>
+<li> MX4J for JMX </li>
+ <li> Tomcat or Jetty for Web Container </li>
+ <li> Axis for Web Services Stack </li>
+ <li> James for email </li>
+ <li> OJB or Hibernate for JDO </li>
+ <li> commons-jndi for JNDI </li>
+</ul>
+<p>
+As well as some non-ASF licenced stuff which is BSD licenced
+</p>
+<ul>
+<li> OpenJms for JMS </li>
+<li> Tyrex for Transaction Manager </li>
+</ul>
+<p>
+As well as the usual infrastructure...
+</p>
+<ul>
+<li> commons-logging / log4j for logging </li>
+<li> Xerces for XML parsing </li>
+<li> maybe more of JakartaCommons as needed </li>
+<li> Maven for building the distributions & website </li>
+<li>JUnit for unit testing </li>
+</ul>
+<p>
+(1) There is currently a JNDI implementation in Tomcat's CVS. It might be
better to move this to Jakarta Commons so we can all work & extend it -
there are various features from Jetty and OpenEjb we'd like to add?
+</p>
+<p>
+<strong>Q: What is Elba?</strong>
+</p>
+<p>
+A: Elba is basically an LGPLed snapshot of JBoss (but not called JBoss to
avoid lawsuits). Its not really intended to be developed or enhanced - its a
temporary code repository of increasingly shrinking code.
+</p>
+<p>
+The idea being for the next (say 1 year) Geronimo by itself isn't gonna be a
full J2EE stack. So rather than suffering a Mozilla-style period of lack of use
- Elba is a temporary LGPL add-on to Geronimo that Jboss code with Geronimo to
provide a full J2EE stack. So from day 1 Geronimo can be used (if so desired)
as a full J2EE stack by using the Elba code.
+</p>
+<p>
+Of course users are totally welcome to just use whats in Geronimo and
nothing else. Or they can drop in other existing services if they wish too. So
Geronimo is a clean normal Apache project. If need be you can drop the Elba
stuff into Geronimo and get a full J2EE stack.
+</p>
+<p>
+So the Elba drop of code is totally optional for those who want to migrate
from JBoss to Geronimo from day 1 and keep a full J2EE stack. Though as soon as
possible all the Elba stuff can be scrapped as Geronimo by itself becomes the
complete J2EE stack (along with the stuff it reuses like Tomcat / Axis / mx4j
etc).
+</p>
+<p>
+e.g. we replace the JMS from JBoss with OpenJMS. We replace the transaction
manager with Tyrex etc. Rewrite the connectors to Tomcat/Jetty/Axis and so
forth. As time goes on Elba shrinks away to nothing.
+</p>
+<p>
+So in summary Elba is a Geronimo distribution which includes dead LGPL code
that can be useful to bootstrap Geronimo. I hope it doesn't exist this time
next year and its use is totally optional.
+</p>
+<p>
+<strong> Q: Administration Overview such as an amalgamation of many projects
or one large project with subject areas.</strong>
+</p>
+<p>
+<strong>Q: Timeline to 1.0 (what does it include).</strong>
+</p>
+<p>
+<strong>Q: Will Geronimo be compliant with Sun's CTS.</strong>
+</p>
+<p>
+<strong>Q: What is Geronimo's Architectural vision and what does the back
plane look like (i.e., is it JMX based?).</strong>
+</p>
+<p>
+<strong>Q: What standards are targeted and which are under active
development?</strong>
+</p>
</section>
</body>
</document>
---------------------------------------------------------------------
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]
