@@ -30,17 +30,24 @@ Following that we'll tell you about how you can test your changes locally and th
3030 It's important to work off the latest changes on the ** development** branch.
3131 ``` bash
3232 # With https
33- git clone https://github.com/your-username/auto-sklearn
33+ # Note the --recurse-submodules args, we use a submodule autosklearn/automl_common
34+ # so it needs to be downloaded too
35+ git clone --recurse-submodules https://github.com/your-username/auto-sklearn
3436
3537 # ... or with ssh
36- git clone
[email protected] :your-username/auto-sklearn.git
38+ git clone
--recurse-submodules [email protected] :your-username/auto-sklearn.git
3739
3840 # Navigate into the cloned repo
3941 cd auto-sklearn
4042
4143 # Create a new branch based off the development one
4244 git checkout -b my_new_branch development
4345
46+ # If you missed the --recurse-submodules arg during clone or need to install the
47+ # submodule manually, then execute the following line:
48+ #
49+ # git submodule udate --init --recursive
50+
4451 # ... Alternatively, if you would prefer a more manual method
4552 # Show all the available branches with a * beside your current one
4653 git branch
@@ -50,6 +57,11 @@ Following that we'll tell you about how you can test your changes locally and th
5057
5158 # Create a new branch based on the currently active branch
5259 git checkout -b my_new_branch
60+
61+ # If you missed the --recurse-submodules arg during clone or need to install the
62+ # submodule manually, then execute the following line:
63+ #
64+ # git submodule udate --init --recursive
5365 ```
5466
5567 The reason to create a new branch is two fold:
@@ -81,7 +93,7 @@ Following that we'll tell you about how you can test your changes locally and th
8193 # If you're using shells other than bash you'll need to use
8294 pip install -e " .[test,examples,doc]"
8395 ` ` `
84- * If you ' re only exposure to using pip is `pip install package_name` then this might be a bit confusing.
96+ * If your only exposure to using pip is ` pip install package_name` then this might be a bit confusing.
8597 * If we type ` pip install -e .` (notice the ' dot' ), this tells ` pip` to install a package located here, in this directory, ` .` .
8698 The ` -e` flag indicates that it should be editable, meaning you will not have to run ` pip install .` every time you make a change and want to try it.
8799 * Finally the ` [test,examples,doc]` tells ` pip` that there' s some extra optional dependencies that we want to install.
@@ -335,6 +347,9 @@ Lastly, if the feature really is a game changer or you're very proud of it, cons
335347 cd auto-sklearn
336348 git checkout -b my_new_branch development
337349
350+ # Initialize autosklearn/automl_common submodule
351+ git submodule update --init --recursive
352+
338353 # Create a virtual environment and activate it so there are no package
339354 # conflicts
340355 python -m venv my-virtual-env
0 commit comments