[
https://issues.apache.org/jira/browse/ZOOKEEPER-80?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=12615817#action_12615817
]
Patrick Hunt commented on ZOOKEEPER-80:
---------------------------------------
Ok, based on Jira comments and thread discussion I propose the following:
1) we'll add a new contrib directory as zookeeper/trunk/src/contrib/<module>
this directory will contain user contributions - such as recipes and the
pending fuse module, ex:
zookeeper/trunk/src/contrib/recipes
zookeeper/trunk/src/contrib/zkfuse (see ZOOKEEPER-25)
let's call these sub-dirs "contrib modules"
2) each module will contain readme/build.xml (or autoconf etc...)/ src, docs,
lib, etc.... subdirectories.
if a module contains more than one lang implemention we would have src/c
src/java etc...
3) recipes (any contrib module really) will have associated documentation in
it's contrib/<module>/docs directory. Note that Hadoop, and ZooKeeper, use
Apache forrest for their documentation and for generating the ASF
hadoop.apache.org web site.
4) recipes will have a single source hierarchy:
contrib/recipes/src/java/main/org/apache/zookeeper/recipes/leaderelection/...
contrib/recipes/src/java/main/org/apache/zookeeper/recipes/locks/...
etc...
5) build.xml for recipes will generate a release jar file
"zookeeper-recipes-<version>.jar", api docs, etc... which will be tar'd and
included in the ZooKeeper release
6) recipe users will be encouraged to use the released jar files in their
client code (no checking out from svn as originally proposed)
7) contrib module issues will be tracked on the zookeeper jira
8) contrib modules are maintained on an "as is, best effort, work in progress"
basis. The contents of these contrib modules are tagged, versioned, built, and
released along with the ZooKeeper clients/server release.
Vote early vote often ;-)
> Document process for client recipe contributions
> ------------------------------------------------
>
> Key: ZOOKEEPER-80
> URL: https://issues.apache.org/jira/browse/ZOOKEEPER-80
> Project: Zookeeper
> Issue Type: Task
> Components: documentation
> Reporter: Patrick Hunt
> Assignee: Patrick Hunt
>
> Per Doug's suggestion I'll use a link instead of copy/paste:
> http://mail-archives.apache.org/mod_mbox/hadoop-zookeeper-dev/200807.mbox/[EMAIL
> PROTECTED]
--
This message is automatically generated by JIRA.
-
You can reply to this email to add a comment to the issue online.
