[katello-devel] Changes to Katello Repository (aka what's this submodule all about?)

[Eric Helms]

The latest in Katello master includes a branch merged in that adds a git 
submodule to the project - ConvergeUI.  This sub-module houses a set of 
shareable UI assets and is required for Katello.  How do you as a 
developer deal with this sub-module?

1) If you are cloning from scratch, you will need to clone recursively, 
e.g.:

git clone --recursive git at github.com:Katello/katello.git

2) If you already have an existing checkout, from the root directory:

git submodule init
git submodule update

This will initialize and then checkout the submodule to the hash that 
the submodule is currently set against.  I will be updating a section of 
the Katello documentation to go more in-depth into developing with 
Converge UI and Katello.  For now, the basics above should get the 
project in proper working order for anyone.

- Eric