# $Id: zsh-development-guide,v 1.3 1995/05/25 09:34:25 coleman Exp coleman $
#
# Guidelines for Zsh Development Group
#

Zsh is currently developed and maintained by the Zsh Development Group.
This development takes place by mailing list.  Check the META-FAQ for the
various zsh mailing lists and how to subscribe to them.  The development
is very open and anyone is welcomed and encouraged to join and contribute.
Because zsh is a very large package whose development can sometimes
be very rapid, I kindly ask that people observe a few guidelines when
contributing patches and feedback to the mailing list.  These guidelines
are very simple and hopefully should make for a more orderly development
of zsh.

1) Send all patches to the mailing list rather than directly to me.

2) Send only context diffs "diff -c oldfile newfile".  They are much
   easier to read and understand while also allowing the patch program
   to patch more intelligently.

3) Please put only one bug fix or feature enhancement in a single patch
   and only one patch per mail message.  This helps me to multiplex
   the many (possibly conflicting) patches that I receive for zsh.
   You shouldn't needlessly split patches, but send them in the smallest
   LOGICAL unit.

4) If a patch depends on other patches, then please say so.  Also please
   mention what version of zsh this patch is for.

5) Please test your patch and make sure it applies cleanly. It
   takes considerably more time to manually merge a patch into the
   baseline code.

Richard Coleman      (Coordinator, Zsh Development Group)
zsh@math.gatech.edu
