From 1cd8207b3d905a8ffd3c26cae071fdc2c6b946ed Mon Sep 17 00:00:00 2001 From: Sam Alba Date: Mon, 4 Apr 2022 15:16:29 -0700 Subject: [PATCH] docs: add tip for support symlink with git on Windows Signed-off-by: Sam Alba --- docs/getting-started/1200-local-dev.md | 8 +++++++- 1 file changed, 7 insertions(+), 1 deletion(-) diff --git a/docs/getting-started/1200-local-dev.md b/docs/getting-started/1200-local-dev.md index 1423c3ba..a25f02af 100644 --- a/docs/getting-started/1200-local-dev.md +++ b/docs/getting-started/1200-local-dev.md @@ -232,7 +232,7 @@ With Docker running, we are ready to download our example app and run its CI/CD Still in your `Command Prompt` terminal: ```shell -git clone https://github.com/dagger/dagger +git clone -c core.symlinks=true https://github.com/dagger/dagger cd dagger git checkout v0.2.4 @@ -240,6 +240,12 @@ cd pkg/universe.dagger.io/examples/todoapp dagger do build ``` +:::tip +By default, git on Windows does not automatically convert posix symbolic links, which explains the extra option `core.symlinks=true` while cloning the repository. + +But you can also enable this once and for all in your git configuration, by running the following command from a Powershell terminal: `git config --global core.symlinks true`. +::: + With an empty cache, installing all dependencies, then testing & generating a build for this example app completes in just under a minute: ```shell