Re: Avery Pennarun's git-subtree?

[Eugene Sajine <euguess@gmail.com>]

On Thu, Jul 22, 2010 at 5:33 PM, Avery Pennarun <apenwarr@gmail.com> wrote:
> On Thu, Jul 22, 2010 at 4:17 PM, Ęvar Arnfjörš Bjarmason
> <avarab@gmail.com> wrote:
>> But it's also clear that we have a lot of tribal knowledge about the
>> lackings of git submodule / git subtree. It would be *really* useful
>> if people like Avery and Jens which have obviously thought hard about
>> the submodule/subtree issues would draft up some (calmly written) docs
>> about how the two differ (with comparison tables etc.).
>>
>> That'd be a very helpful resource for Git users in deciding which one
>> to use.
>
> I think I'm too biased to write that, but if someone else wants to
> take the lead, I could certainly contribute.
>
> Have fun,
>
> Avery


I personally tried to understand submodules, but my attempts to find
easy way to use them have failed miserably;) probably i have to spend
even more time in order to understand if i can benefit from them or
not. So, i think this kind of comparison would be very beneficial for
"mere mortals"

I would like to share an idea how it can be organized:

We could create a file in doc section of git.git or in Avery's repo
named git_submodule_vs_git_subtree or just use a separate topic of the
list.

The file would look like this:

git-submodule |           feature                  | git-subtree
______________________________________________________________________
     +        | ability to tag submodule without   |     -
   (comments) | tagging the whole tree             |  (comments)
______________________________________________________________________


Avery and Jens could add features they think are beneficial for one
project or another and answer to each other this way. They could mark
just presence or abscence of the feature by +/- like above or specify
key approaches how to do different things.
For example, how to configure new submodule (main sequence of commands
to create, add ), how to do that with sub-tree...

I think this simple feature matrix will answer a lot of questions.

just my 2 cents...

Thanks,
Eugene