Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
Browse files

Improved the README

  • Loading branch information...
commit 92da9c9aaabd529655c53e743a46435ad91ac0be 1 parent 49641ae
Johan Tibell tibbe authored
Showing with 56 additions and 0 deletions.
  1. +56 −0 README
56 README
View
@@ -3,3 +3,59 @@ Hyena
Hyena is a simple web application container that can be used to run
Haskell web applications behind more robust web servers like Apache.
+
+Contributing
+------------
+
+### Prerequisites
+
+Make sure you read the [Haskell Style Guide] [1].
+
+The existing code doesn't follow the style guide fully but you should
+follow it for all new code.
+
+### Creating patches
+
+The preferred way of contributing changes to the project is to use Git
+and send the patches over email using the Git commands `format-patch`
+and `send-email`. Step by step instructions:
+
+Clone the repository:
+
+ git clone http://github.com/tibbe/hyena
+
+Make your changes:
+
+ cd hyena
+ $EDITOR <file>
+
+Commit your changes in one or more commits:
+
+ git add <file>
+ git commit
+
+Make sure you write a good commit message. Commit messages should
+contain a short summary on a separate line and, if needed, a more
+thorough explanation of the change. Write full sentences and use
+proper spelling, punctuation, and grammar. See
+[A Note About Git Commit Messages] [2] for more information.
+
+You might want to use `git rebase` to make sure your commits
+correspond to nice, logical commits. Make sure whitespace only
+changes are kept in separate commits to ease reviewing.
+
+Prepare the e.g. last five patches for sending:
+
+ git format-patch -5 -n
+
+This will create one patch file per patch.
+
+ git send-email --to <maintainer> <patch files>
+
+The maintainer is specified in the Cabal file. The maintainer will
+review your changes and may ask you to make changes to them. Make the
+changes to your local repository and use `git rebase` to massage them
+into nice, logical commits and resend the patches.
+
+[1]: http://github.com/tibbe/haskell-style-guide
+[2]: http://www.tpope.net/node/106
Please sign in to comment.
Something went wrong with that request. Please try again.