From dev-return-19410-apmail-couchdb-dev-archive=couchdb.apache.org@couchdb.apache.org Wed Nov 23 10:14:16 2011 Return-Path: X-Original-To: apmail-couchdb-dev-archive@www.apache.org Delivered-To: apmail-couchdb-dev-archive@www.apache.org Received: from mail.apache.org (hermes.apache.org [140.211.11.3]) by minotaur.apache.org (Postfix) with SMTP id DE77F7C44 for ; Wed, 23 Nov 2011 10:14:15 +0000 (UTC) Received: (qmail 55556 invoked by uid 500); 23 Nov 2011 10:14:15 -0000 Delivered-To: apmail-couchdb-dev-archive@couchdb.apache.org Received: (qmail 54895 invoked by uid 500); 23 Nov 2011 10:14:14 -0000 Mailing-List: contact dev-help@couchdb.apache.org; run by ezmlm Precedence: bulk List-Help: List-Unsubscribe: List-Post: List-Id: Reply-To: dev@couchdb.apache.org Delivered-To: mailing list dev@couchdb.apache.org Received: (qmail 54887 invoked by uid 99); 23 Nov 2011 10:14:12 -0000 Received: from nike.apache.org (HELO nike.apache.org) (192.87.106.230) by apache.org (qpsmtpd/0.29) with ESMTP; Wed, 23 Nov 2011 10:14:12 +0000 X-ASF-Spam-Status: No, hits=-0.0 required=5.0 tests=RCVD_IN_DNSWL_NONE,SPF_PASS X-Spam-Check-By: apache.org Received-SPF: pass (nike.apache.org: domain of dionne@dionne-associates.com designates 67.222.38.55 as permitted sender) Received: from [67.222.38.55] (HELO oproxy5-pub.bluehost.com) (67.222.38.55) by apache.org (qpsmtpd/0.29) with SMTP; Wed, 23 Nov 2011 10:14:04 +0000 Received: (qmail 17994 invoked by uid 0); 23 Nov 2011 10:13:42 -0000 Received: from unknown (HELO host183.hostmonster.com) (74.220.207.183) by cpoproxy2.bluehost.com with SMTP; 23 Nov 2011 10:13:42 -0000 DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=dionne-associates.com; s=default; h=To:References:Message-Id:Content-Transfer-Encoding:Date:In-Reply-To:From:Subject:Mime-Version:Content-Type; bh=BtvzN0C6DcF3dF2jZQbo6kcLMph4cxJkMXE2vttlXK8=; b=Lr6kyUMW+wS+S5Wmrm/HErf8SXYLtXm8rj9OZtJU3Df7ZfcbCCwLCDmHsdmM40BLCsda9oeAEcI9Pw4HBGNfEiKTPtEWHHsc4ytDo9lc32md2PwFHi1i3q1u9xHf/ZW3; Received: from adsl-99-42-252-164.dsl.wlfrct.sbcglobal.net ([99.42.252.164] helo=[192.168.1.102]) by host183.hostmonster.com with esmtpa (Exim 4.76) (envelope-from ) id 1RT9pl-0000zz-QJ; Wed, 23 Nov 2011 03:13:41 -0700 Content-Type: text/plain; charset=us-ascii Mime-Version: 1.0 (Apple Message framework v1251.1) Subject: Re: Proposal for Intro to CouchDB Coding class From: Robert Dionne In-Reply-To: Date: Wed, 23 Nov 2011 05:13:41 -0500 Content-Transfer-Encoding: quoted-printable Message-Id: <57C80709-1372-4C7C-AE76-976FC4787CF9@dionne-associates.com> References: To: dev@couchdb.apache.org, X-Mailer: Apple Mail (2.1251.1) X-Identified-User: {2551:host183.hostmonster.com:dionneas:dionne-associates.com} {sentby:smtp auth 99.42.252.164 authed with dionne@dionne-associates.com} X-Virus-Checked: Checked by ClamAV on apache.org +5 - excellent idea! Right now the couchdb code is pretty much self-documenting, which makes = it pretty hard for new adopters, and there's no independent = documentation of the critical pieces outside the code (file formats, = etc..). So every bug is a new adventure.=20 Perhaps as part of this course, these guided tours might result in more = documentation in the code. I find having as much as possible with the = code increases the likelihood that it stays current. With respect to Erlang I found the Armstrong book very readable. Anyway I'm happy to help with the "ask the developer" forum.=20 On Nov 23, 2011, at 1:24 AM, Joan Touzet wrote: > Hello CouchDB Developers, >=20 > Based on an informal survey of CouchDB users who are interested in > contributing to the project, two key items tend to hold people back: >=20 > 1. Knowing Erlang (and the CouchDB coding style) > 2. Knowing the CouchDB code base >=20 > So I decided to further my own grad research in Education, and > contribute back to CouchDB, by volunteering to coordinate a class for > 6-20 students. >=20 > ** I'd like to propose an Introduction to CouchDB Programming course, > kicking off January 5, 2012, and ask for support from the current devs > on this list. >=20 > This won't be a traditional classroom course! Students themselves will > be shaping the direction of the course, the topics covered, and will = be > expected to lead at least one week of online discussion. (I'll be > providing the pedagogical framework for this Collaborative Learning > model. This is my area of active research.) >=20 > The idea is that, by the end of course (10 weeks or so), participants > will have learned enough Erlang to have basic competency, and enough > about the CouchDB code base to contribute. The "final exam" would be > completing and submitting some number of patches from the outstanding > bin of bugs in JIRA. >=20 > ** I NEED YOUR HELP in two ways: >=20 > A. Suggestions for good reference material (e.g. learnyousomeerlang) > B. Volunteers from the current devs to conduct a "guided tour" of > 1 or more parts of the code >=20 > The "guided tours" are the essential bits for this class to be > successful, and I'd like them as much as possible to be accurate and > accessible to newbs. These tours could take many forms: >=20 > * A screencast of you talking about some code, e.g. ScreenFlow > * A live walkthrough over Adobe Connect video (time donated by my > University dep't for the class) > * IRC-based runthrough > * "Ask the developer" - respond to questions about code on the class > forum > * You fly everyone out to your house for dinner :) Etc. >=20 > ** If you're willing to help out, please reply on or off list and let = me > know. Let's grow the contributor community! >=20 > All the best, > --=20 > Joan Touzet | joant@atypical.net | wohali most other places