Skip to content

Commit

Permalink
Update devonfw-ide-contribution-getting-started.asciidoc
Browse files Browse the repository at this point in the history
  • Loading branch information
hohwille authored Aug 2, 2022
1 parent 8c22c67 commit 3c49143
Showing 1 changed file with 9 additions and 4 deletions.
13 changes: 9 additions & 4 deletions documentation/devonfw-ide-contribution-getting-started.asciidoc
Original file line number Diff line number Diff line change
Expand Up @@ -98,10 +98,15 @@ In the configuration files many link:variables.asciidoc[variables] can be define
The following sub-sections give you some tipps and tricks to boost your productivty when developing features for `devonfw-ide`.

== Symbolic Links
With https://schinagl.priv.at/nt/hardlinkshellext/linkshellextension.html[symbolic links] you can use one file that is located inside one directory in multiple other directories, without copying the whole file into the other directories. The file is still only saved at the initial location, but can be accessed through the created links in a much more comfortable way. So you are actually just linked to the original file and therefore don't have to worry about differing versions of the file in your directories. This is very helpful for testing our devon-ide, because e.g. the commandlets folder for testing is not the same as the commandlets folder for git-commits.
Follow https://schinagl.priv.at/nt/hardlinkshellext/linkshellextension.html[these] installation and usage instructions first.
Later on you can make symbolic links of files from your "git folder" and add them into the folder in which the testing is supposed to take place.
E.g. make a symbolic link of `${DEVON_IDE_HOME}/workspaces/ide/scripts/src/main/resources/scripts/command/docker` and insert it into the folder `${DEVON_IDE_HOME}/scripts/command`.
With link:advanced-tooling-windows.asciidoc##create-symbolic-links[symbolic links] you can use one file or folder that is located inside one directory in one or multiple other directories, without copying the whole file or folder into the other directories.
The file is still only saved at the initial location, but can be accessed through the created links in a much more comfortable way.
So you are actually just linked to the original file and therefore don't have to worry about differing versions of the file in your directories.
This is very helpful for testing our devon-ide, because e.g. the commandlets folder for testing is not the same as the commandlets folder for git-commits.
Install https://schinagl.priv.at/nt/hardlinkshellext/linkshellextension.html[link shell extension] and follow the instructions for installation and usage first.
Later on you can make symbolic links of files or folder from your "git folder" and add them into the folder in which the testing is supposed to take place:

So select the folder `${DEVON_IDE_HOME}/workspaces/ide/scripts/src/main/resources/scripts/command/` and choose `Pick Link Source` and then go to `${DEVON_IDE_HOME}/scripts/` delete the `command` folder and re-create it as symbolic link via `Drop as... > Symbolic link`.
Do the same also for `functions`, `environment-project`, `environment-project.bat`, `devon`, `devon.bat`, `autocomplete`, and `devon-autocomplete`.
Now changes you make in the first mentioned file will directly be available in your testing environment through the created file-link in the testing environment.

=== developer tools
Expand Down

0 comments on commit 3c49143

Please sign in to comment.