Author: tziade
Date: Tue Mar 28 03:33:01 2006
New Revision: 2740

Added:
   cookbook/trunk/how_to_participate.txt   (contents, props changed)
Log:
added a 'howto participate' document

Added: cookbook/trunk/how_to_participate.txt
==============================================================================
--- (empty file)
+++ cookbook/trunk/how_to_participate.txt       Tue Mar 28 03:33:01 2006
@@ -0,0 +1,79 @@
+How to participate
+__________________
+
+Setting up your sandbox
+=======================
+
+First of all you need to get an access over the svn, ask Tarek.
+
+Then you can get a checkout of the cookcook with a svn co::
+
+    svn co https://svn.z3lab.org/z3lab/cookbook/trunk cookbook
+
+The cookbook is a Zope 3 package, you can add to your instance
+in your lib/python folder. Its tests can be run from the instance::
+
+    bin/test -vp cookbook
+
+You might want to check this document that explains how tests are extracted::
+
+    http://svn.z3lab.org/trac/z3lab/file/cookbook/trunk/tests.txt
+
+
+The server has a commit hook, you can receive mails on each commit,
+just ask for it.
+
+You want to write recipes
+=========================
+
+Recipes are latex files, take a look at the DummyRequest to
+get a clue::
+
+    http://svn.z3lab.org/trac/z3lab/file/cookbook/trunk/recipe00.en.tex
+
+
+If you are under Linux, i really advice you to use Kile, you'll find Kile 
project
+files for each language on the svn.
+
+The recipe lists is holder here::
+
+    http://svn.z3lab.org/trac/z3lab/file/cookbook/trunk/recipe_list.txt
+
+You can just start up your writing, by adding your initial besides the recipe
+you want. If the recipe you want to do is not listed, let's add it but
+please ask me so I validate it.
+
+Keep in mind that Recipe must stay short (max: 5 rendered page) and focus
+on one specific topic.
+
+You want to translate recipes
+=============================
+
+Add your initial besides the recipe, with the translation done. example::
+
+     (fr->en, TZ)
+
+then add your name at the beginning of the latex file:
+
+    \translator{Tarek Ziad�}
+
+
+Review process
+==============
+
+We'll probably integrate a review process later, to increase recipe quality,
+language style, etc..
+
+License matters, how the project is driven
+==========================================
+
+I (Tarek) manage the project but contributors are welcome. They all
+appears in the website::
+
+    http://zope-cookbook.org/about
+
+and will always appear on any way the cookbook is shown.
+
+Someone who write or translate a recipe agrees that the recipe becomes part of
+the cookbook, and therefore has its licencing and cannot be reproduced 
somewhere
+else, except the source code.
-- 
http://lists.nuxeo.com/mailman/listinfo/z3lab-checkins

Reply via email to