Return-Path: Delivered-To: apmail-jackrabbit-dev-archive@www.apache.org Received: (qmail 3663 invoked from network); 30 Aug 2006 13:16:32 -0000 Received: from hermes.apache.org (HELO mail.apache.org) (209.237.227.199) by minotaur.apache.org with SMTP; 30 Aug 2006 13:16:32 -0000 Received: (qmail 37743 invoked by uid 500); 30 Aug 2006 13:16:23 -0000 Delivered-To: apmail-jackrabbit-dev-archive@jackrabbit.apache.org Received: (qmail 37658 invoked by uid 500); 30 Aug 2006 13:16:22 -0000 Mailing-List: contact dev-help@jackrabbit.apache.org; run by ezmlm Precedence: bulk List-Help: List-Unsubscribe: List-Post: List-Id: Reply-To: dev@jackrabbit.apache.org Delivered-To: mailing list dev@jackrabbit.apache.org Received: (qmail 37622 invoked by uid 99); 30 Aug 2006 13:16:22 -0000 Received: from asf.osuosl.org (HELO asf.osuosl.org) (140.211.166.49) by apache.org (qpsmtpd/0.29) with ESMTP; Wed, 30 Aug 2006 06:16:22 -0700 X-ASF-Spam-Status: No, hits=0.5 required=10.0 tests=DNS_FROM_RFC_ABUSE,SPF_PASS X-Spam-Check-By: apache.org Received-SPF: pass (asf.osuosl.org: domain of jukka.zitting@gmail.com designates 64.233.184.229 as permitted sender) Received: from [64.233.184.229] (HELO wr-out-0506.google.com) (64.233.184.229) by apache.org (qpsmtpd/0.29) with ESMTP; Wed, 30 Aug 2006 06:16:21 -0700 Received: by wr-out-0506.google.com with SMTP id i21so18050wra for ; Wed, 30 Aug 2006 06:16:01 -0700 (PDT) DomainKey-Signature: a=rsa-sha1; q=dns; c=nofws; s=beta; d=gmail.com; h=received:message-id:date:from:to:subject:mime-version:content-type:content-transfer-encoding:content-disposition; b=FyPbUhpqGd4awwqVW4oQL03dmXDnkzNR4/0urVUk2CuPGNXZ2OrOw6GsRbksB/1pHDm+ARHcPH/erwmDYIBOuftg7vNkK/rG4DpQAZTaY3zxApjGfyeI2PZ7P/QCPk7ciUtbyVYIArhWXbIV1JM7JL6kNqjyDikEXXM7tvVA+UM= Received: by 10.90.78.1 with SMTP id a1mr141649agb; Wed, 30 Aug 2006 06:16:00 -0700 (PDT) Received: by 10.90.96.17 with HTTP; Wed, 30 Aug 2006 06:16:00 -0700 (PDT) Message-ID: <510143ac0608300616m1d0d0822xe64a1ee7d2c818cd@mail.gmail.com> Date: Wed, 30 Aug 2006 16:16:00 +0300 From: "Jukka Zitting" To: dev@jackrabbit.apache.org Subject: Improving the accessibility of the Jackrabbit core MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8; format=flowed Content-Transfer-Encoding: 7bit Content-Disposition: inline X-Virus-Checked: Checked by ClamAV on apache.org X-Spam-Rating: minotaur.apache.org 1.6.2 0/1000/N Hi, Based on private discussions I'd like to raise the issue of the accessibility of the Jackrabbit core codebase. We have a small number of people who are intimately familiar with the core codebase (see the numbers below), but others find the core hard to navigate and that this drives up the barrier of entry of contributing to Jackrabbit. Please share any good ideas on how we could best lower the barrier. I'm open to all sorts of ideas, like more documentation (javadocs, UML diagrams, architectural descriptions, etc.), scheduled Q&A sessions on IRC, an informal Jackrabbit workshop during the Hackathon in ApacheCon, etc. I'm also interested in the priorities, i.e. what would give us the most "bang for buck" in terms of making it easier for people to get familiar with the Jackrabbit core and start contributing. $ svn log src/main/java/org/apache/jackrabbit/core | \ perl -lne '/^r[0-9]+ \| (.*?) \|/ and print $1' | sort | uniq -c | sort -n -r 371 stefan 199 tripod 185 mreutegg 127 jukka 27 dpfister 13 fielding 10 angela 4 fmeschbe 3 edgarpoce 2 sylvain BR, Jukka Zitting -- Yukatan - http://yukatan.fi/ - info@yukatan.fi Software craftsmanship, JCR consulting, and Java development