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.
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