You are viewing a plain text version of this content. The canonical link for it is here.
Posted to site-cvs@jakarta.apache.org by hu...@apache.org on 2002/01/23 21:33:34 UTC
cvs commit: jakarta-site2/xdocs/site contributing.xml getinvolved.xml
husted 02/01/23 12:33:34
Modified: xdocs/site getinvolved.xml
Added: xdocs/site contributing.xml
Log:
Put Craig's piece about contributing into a file, so we don't have to link into a mail archive.
Revision Changes Path
1.7 +2 -4 jakarta-site2/xdocs/site/getinvolved.xml
Index: getinvolved.xml
===================================================================
RCS file: /home/cvs/jakarta-site2/xdocs/site/getinvolved.xml,v
retrieving revision 1.6
retrieving revision 1.7
diff -u -r1.6 -r1.7
--- getinvolved.xml 9 Jan 2002 00:59:56 -0000 1.6
+++ getinvolved.xml 23 Jan 2002 20:33:34 -0000 1.7
@@ -52,13 +52,11 @@
<p>
Here is one developer's advice how to get involved. It specifically
talks about Tomcat, but the general idea can applied to any of the
-Jakarta projects.
+Jakarta subprojects.
</p>
<ul>
-<li><a
-href="http://w4.metronet.com/~wjm/tomcat/2000/Nov/msg00073.html">Getting
-Involved</a> -- Craig R. McClanahan</li>
+<li><a href="contributing.html">Contributing</a> -- Craig R. McClanahan</li>
</ul>
<p>
1.1 jakarta-site2/xdocs/site/contributing.xml
Index: contributing.xml
===================================================================
<?xml version="1.0"?>
<document>
<properties>
<author email="craigmcc@apache.org">Craig R. McClanahan</author>
<title>Contributing</title>
</properties>
<body>
<section name="Contributing">
<p><i>This was originally posted on the Tomcat DEV list,
but applies equally well to any Jakarta subproject.</i></p>
<pre>
Michael Percy wrote:
> I believe there would be (or at least SHOULD be! :) many
> more contributors to these projects (Tomcat), but maybe
> some of us are intimidated by the level of apparent
> expertise required for this stuff. (Then again, I know
> we have some damn good people on these lists.) I am
> curious, is this the case? Have you all been writing
> java apps for years and are steeped in C++ and OOP for
> the last decade? Do you have the servlet spec pasted on
> your wall?
</pre>
<p>
Michael,
</p>
<p>
In my particular case the servlet spec is pasted on the inside of my eyeballs
:-) But I'm kind of a wierd case in that respect, because I'm on the JSR-053
expert group that worked on the new specs (servlet 2.3 / JSP 1.2).
</p>
<p>
Personally, I've been a software developer/designer/architect in some fashion or
another for more years (and in more languages) than I care to admit. But I got
involved in the Apache JServ project (predecessor to Tomcat) a few years ago
when I needed a cheap server solution for an Internet-based application that I
needed to build. Like everyone, I was grumbling about how long it took for
JServ to get to final release (over a year from 0.9 to 1.0), until my son -- who
likes PHP but I love him anyway :-) -- said "Dad, you know Java, get in there
and help them finish it!". So I did.
</p>
<p>
I wouldn't worry to much about expertise (although clearly Java is a must, and
familiarty with the specifications that Tomcat implements -- servlet, JSP, HTTP,
etc. -- is vital on this particular project). The ways that people get involved
in open source are pretty varied, but a common course might go something like
this:
</p>
<ul>
<li>
You see something that you think should be
added, or that doesn't seem to work quite right
</li>
<li>
You investigate the existing code, becoming more
familiar with it along the way
</li>
<li>
You might ask a "what would you think if we did this?"
type question on the developer list
</li>
<li>
You contribute to the discussion of these ideas
(yours and others) - partly to gain knowledge but also
partly to become known to the community
</li>
<li>
At some point, you propose a patch, or a new chunk
of code that gets accepted into the code base (the
detailed rules for Tomcat are on the Jakarta web site)
</li>
<li>
Iterate the above a few times, perhaps looking at bigger
and bigger chunks of code as you gain more understanding
</li>
<li>
At some point, when it is evident that you're not a bozo :-),
you can get nominated for committer status and voted on
by the developer community, and then be able to post the
changes directly yourself.
</li>
</ul>
<pre>
> How can I, a perl hacker and aspiring java coder get
> involved? (How do you guys know what to do?) At what
> point would I be considered to be "good enough" to
> really contribute some code? Server-side java simply
> rocks, and if I could help make it a more viable
> option for everyone (including myself and my company)
> then I would love to do it.
</pre>
<p>
It all starts by becoming familiar enough with the current code base to start
understanding it. In most open source projects there is never enough
architectural documentation, so this often involves asking "how does this work"
type questions on the developer list. Don't feel bad about that -- NONE of us
knew anything about Tomcat internals before we started working on it :-)
</p>
<pre>
> Hope this isn't a totally inane question, but it has
> been on my mind for a couple weeks. Just wondering...
</pre>
<p>
Not at all inane -- I hope the above thoughts help.
</p>
<pre>
> Thanks,
> Mike
</pre>
<p>
Craig
</p>
<p>
03 Nov 2000
</p>
</section>
</body>
</document>
--
To unsubscribe, e-mail: <ma...@jakarta.apache.org>
For additional commands, e-mail: <ma...@jakarta.apache.org>