Contribute We're excited that Genome has become a community project! There are a few things to know regarding Genome community participation
Licensing All Genome source and pre-built binaries are provided under the GNU General Public License, version 2
Design Axiom The Genome framework really tries to delegate as much functionality as it can to tools that are invented to do a particular function. That said, any code contributed to glue tools together should be as minimal as possible to get the job done.
Community Now that you're ready to be an active community member, here are a few directions to get you started.
Please Be Friendly We strongly encourage everyone participating in the Genome community to be friendly and courtious toward other community members. Of course, being courteous is not the same as failing to constructively disagree with each other, but it does mean that we should be respectful of each other when enumerating the 42 technical reasons that a particular proposal may not be the best choice. There's never a reason to be antagonistic or dismissive toward anyone who is sincerely trying to contribute to a discussion
Community Communication The best way to participate in the community is to use the mailing list and/or the IRC channel. The mailing list is genome-list@redhat.com and the IRC channel is #genome on irc.freenode.net.
Working With The Code If you're not familiar with the Git source code management tool, do yourself a favor and take time to get over the learning curve. It's bliss once you 'get it'
Checkout The Code Developer Checkout URI: ssh://git.fedorahosted.org/git/genome Anonymous Checkout URI: git://git.fedorahosted.org/git/genome or http://git.fedorahosted.org/git/genome The Genome project code is seperated into several Git repositories. The code repositories are granular so that the repositories are small and easy to work with. We have sepearted core tooling, core documentation, puppet configuration manifests, third party tool extensions, application code, and website into their respective Git repositories. When you clone the Git repository from fedorahosted.org/git/genome, that is actually a supermodule, which references all the git repositories hosted on gitorious.org. If you do want to get use get all the Genome code at once, you can use the fedorahosted.org/git/genome URL. # Clone the Genome supermodule git clone git://git.fedorahosted.org/git/genome # Move into the cloned supermodule cd genome # Then initialize the submodules git submodule init # Then do the actual cloning of the remote submodules, if you already have them checked out, this will update the submodules locally git submodule update If you want to work with a specific Git repository, you can review the gitorious genome project and then use the clone urls listed for each Git repository under the project. For example, if I want to clone the Genome tools repository I would go to http://gitorious.org/projects/genome/repos/tools and the choose a clone URL. # Clone the tools git repository git clone git://gitorious.org/genome/tools