Git submodules

Git submodules are complicated. Here is some recommended readings:

Documentation:

• https://git-scm.com/book/en/v2/Git-Tools-Submodules
• https://www.atlassian.com/git/tutorials/git-submodule

Short article:

• https://github.blog/2016-02-01-working-with-submodules/

Longer Tutorial:

• https://medium.com/@porteneuve/mastering-git-submodules-34c65e940407

We use submodules for modularization. It's important to remember that a parent module pegs to a particular submodule commit point, not to a branch. The parent module does not automatically get the updates when the submodule is updated. This allows the authors of the submodule to do work without worry about breaking parents until the parents actually update their submodules. In this way, they work like versioned libraries.