From ab44a043d6a1b37fc5f2a296570092f609b251cd Mon Sep 17 00:00:00 2001 From: Dan Albert Date: Mon, 10 May 2021 17:17:56 -0700 Subject: [PATCH] Update git docs. --- Developer's-Guide.md | 16 +++++++++++++++- 1 file changed, 15 insertions(+), 1 deletion(-) diff --git a/Developer's-Guide.md b/Developer's-Guide.md index 7866026..83cbab5 100644 --- a/Developer's-Guide.md +++ b/Developer's-Guide.md @@ -27,6 +27,20 @@ When you install Python, make sure to install pip for dependencies management. T * **master** : Should be even with current release version * **develop** : Current version being worked on, might be unstable +The following instructions work for the git command line. If using the GitHub Desktop or `gh` tools, the steps will be the same but the exact commands will differ. + +To get started with development, run: + +``` +git clone --recurse-submodules https://github.com/dcs-liberation/dcs_liberation.git +``` + +This will automatically check out the develop branch. The `--recurse-submodules` flag ensures that our local copy of `pydcs` (a dependency we use) is also checked out. It is also a good idea to configure `git pull` to automatically update submodules. To do this, run: + +``` +git config --global submodule.recurse true +``` + ## Creating a Python virtual environment A Python virtual environment (virtualenv) is a local copy of the Python distribution for a specific project. This allows you to install the project dependencies local to the environment rather than globally on your system, which makes it easier to reset your environment if something goes wrong. @@ -60,6 +74,6 @@ https://github.com/Khopa/dcs_liberation/wiki/Release-process Please make a new branch from either develop or master, and make your pull requests to khopa/develop. - +If you're new to GitHub, https://guides.github.com/introduction/flow/ and the other tutorials on that site may be helpful.