Submodule - link to another Git repository

"A common issue arises in these scenarios: you want to be able to treat the two projects as separate yet still be able to use one from within the other.

Git addresses this issue using submodules. Submodules allow you to keep a Git repository as a subdirectory of another Git repository. This lets you clone another repository into your project and keep your commits separate."

🤓 Git documentation: https://www.git-scm.com/book/en/v2/Git-Tools-Submodules

Before Repo -- without running the commands below

Command with the URL of the project you would like to start tracking.

👇

// Enter local computer project
$ cd ~/projects/name-project

// Add submodule
$ git submodule add <URL GitHub project>

// Add commit
$ git commit -am 'Add submodule'

• Sometimes we can need the next command if you used checkout to change other branches:

// Update submodule if you used checkout command
$ git submodule update --init --recursive

After Repo -- if you run the above commands

OTHER OPTION: You would like to start tracking in a new branch.

👇

// For creating a new branch use command:
$ git checkout -b add-branch-submodule

// Add submodule
$ git submodule add <URL GitHub project>

// Add commit
$ git commit -am 'Add submodule'

// Switched to branch 'master'
$ git checkout --recurse-submodules master

// Check status
$ git status
On branch master
Your branch is up-to-date with 'origin/master'.

// after the checkout, you can use:
$ git submodule update --init --recursive

"If you haven’t committed your changes in your submodule and you run a submodule update that would cause issues, Git will fetch the changes but not overwrite unsaved work in your submodule directory."

$ git submodule update --remote

Some recourses:

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

• https://stackoverflow.com/questions/36554810/how-to-link-folder-from-a-git-repo-to-another-repo

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