From 60b62e370ee566010f88e65df3981125dc17be2d Mon Sep 17 00:00:00 2001 From: Spartan322 Date: Thu, 7 Sep 2023 16:06:30 -0400 Subject: Simplify README.md Add system-requirements.md Add using-git-bisect.md Add run-build-export.md Add cloning.md Add debugging.md Add rebasing.md Includes PR squashing Simplify .vscode/launch.json --- docs/contribution/cloning.md | 22 ++++++++++++++++++++++ 1 file changed, 22 insertions(+) create mode 100644 docs/contribution/cloning.md (limited to 'docs/contribution/cloning.md') diff --git a/docs/contribution/cloning.md b/docs/contribution/cloning.md new file mode 100644 index 0000000..06a84bb --- /dev/null +++ b/docs/contribution/cloning.md @@ -0,0 +1,22 @@ +# Cloning + +If you do not have Git installed foremost you need to install it at https://git-scm.com/download. + +Once installed you need to clone OpenVic: +```sh +git clone https://github.com/OpenVicProject/OpenVic.git +``` +After cloning you must initialize and update the submodules: +```sh +cd OpenVic +git submodule update --init --recursive +``` +Updating the submodules is neccessary every time the dependencies are updated, if you're unsure, on every `git pull` you should also call `git submodule update --init --recursive` + +To update the repo you must pull the repo: +```sh +git pull +``` +Git may install a gui with it, this gui can be a useful external tool for doing things related to git, (especially commits) you can open it via `git gui`. + +Further tutorials and documentation on git can be found at https://git-scm.com/book. \ No newline at end of file -- cgit v1.2.3-56-ga3b1