From harmony-dev-return-2092-apmail-incubator-harmony-dev-archive=incubator.apache.org@incubator.apache.org Sun Oct 02 10:05:38 2005 Return-Path: Delivered-To: apmail-incubator-harmony-dev-archive@www.apache.org Received: (qmail 15551 invoked from network); 2 Oct 2005 10:05:34 -0000 Received: from hermes.apache.org (HELO mail.apache.org) (209.237.227.199) by minotaur.apache.org with SMTP; 2 Oct 2005 10:05:34 -0000 Received: (qmail 89678 invoked by uid 500); 2 Oct 2005 10:05:22 -0000 Delivered-To: apmail-incubator-harmony-dev-archive@incubator.apache.org Received: (qmail 89616 invoked by uid 500); 2 Oct 2005 10:05:21 -0000 Mailing-List: contact harmony-dev-help@incubator.apache.org; run by ezmlm Precedence: bulk List-Help: List-Unsubscribe: List-Post: List-Id: Reply-To: harmony-dev@incubator.apache.org Delivered-To: mailing list harmony-dev@incubator.apache.org Received: (qmail 89605 invoked by uid 99); 2 Oct 2005 10:05:20 -0000 Received: from asf.osuosl.org (HELO asf.osuosl.org) (140.211.166.49) by apache.org (qpsmtpd/0.29) with ESMTP; Sun, 02 Oct 2005 03:05:20 -0700 X-ASF-Spam-Status: No, hits=0.0 required=10.0 tests= X-Spam-Check-By: apache.org Received-SPF: neutral (asf.osuosl.org: local policy) Received: from [83.160.152.237] (HELO gnu.wildebeest.org) (83.160.152.237) by apache.org (qpsmtpd/0.29) with ESMTP; Sun, 02 Oct 2005 03:05:23 -0700 Received: from elsschot.wildebeest.org ([192.168.1.26]) by gnu.wildebeest.org with esmtp (Exim 3.36 #1 (Debian)) id 1EM0ip-0002n5-00 for ; Sun, 02 Oct 2005 12:05:31 +0200 Subject: Re: [project policy] Author credit and attribution From: Mark Wielaard To: harmony-dev@incubator.apache.org In-Reply-To: <12ED61E0-1039-42DF-B353-C2865A440797@apache.org> References: <12ED61E0-1039-42DF-B353-C2865A440797@apache.org> Content-Type: multipart/signed; micalg=pgp-sha1; protocol="application/pgp-signature"; boundary="=-1edyYoXS4/RELQZo6Pn7" Date: Sun, 02 Oct 2005 12:04:55 +0200 Message-Id: <1128247495.6126.16.camel@localhost.localdomain> Mime-Version: 1.0 X-Mailer: Evolution 2.2.3 X-Virus-Checked: Checked by ClamAV on apache.org X-Spam-Rating: minotaur.apache.org 1.6.2 0/1000/N --=-1edyYoXS4/RELQZo6Pn7 Content-Type: text/plain Content-Transfer-Encoding: quoted-printable Hi, If you are looking for some guidelines for working together on code and how to keep track of who wrote what when then I would recommend starting out with our GNU Classpath Hacker Guide. Specifically chapter 7. "Working on the code, Working with others". It explains that the main rule is to always explain and discuss everything on the patches mailinglists. No commit is made before it has been posted first. http://www.gnu.org/software/classpath/docs/hacking.html#SEC8 Just following that main rule makes sure that everybody knows what and why things happen. Next there are all kinds of practical guidelines such as maintaining a clear and concise ChangeLog for every commit. Splitting commits for unrelated code changes, or changes to code and changes to formatting, etc for clarity. And when to ask for permission to commit a change. Also important is to always use the same code style guide (see chapter 6) so that the code looks like it is part of a whole. There is currently no strict rule about "author tags". Some people add them some don't. This isn't really a problem. The ChangeLog file documents in very precise detail who really wrote what (and of course CVS has a similar record if you happen to be online). And there is a AUTHORS file listing all active hackers and a THANKS file for documenting who else helped out with bug reports, hints or moral support. Also the release announcements always include a full list of all contributors and a summary of their contributions. Currently there are about 80 committers creating around 15 patches a day. And the Hacker Guide really helps to keep some structure to the project without being so strict that it makes contributing difficult. Cheers, Mark --=-1edyYoXS4/RELQZo6Pn7 Content-Type: application/pgp-signature; name=signature.asc Content-Description: This is a digitally signed message part -----BEGIN PGP SIGNATURE----- Version: GnuPG v1.4.2 (GNU/Linux) iD8DBQBDP7DHxVhZCJWr9QwRAtV7AKCU3BiND0wfTFFUbF1yNBsUVXIptACglqlm 5TTaeYLlE3VmCCk8Y7pAI54= =sYkY -----END PGP SIGNATURE----- --=-1edyYoXS4/RELQZo6Pn7--