#1063: improved missleading documentation (for user specific workspace configuration)

[JoelAdbu]

This PR fixes #1063

Implemented changes:

• clarified documentation regarding user-specific IDE workspace configuration
• documented that workspace templates can also be defined in ~/.ide/«ide»/workspace/
• added note about required directory structure (settings subfolder)

---

Testing instructions

Please add conscise, understandable instructions on how a reviewer can test/verify the functionality of your contribution here:

1. Add custom workspace configuration files to ~/.ide/intellij/workspace/update/.intellij/config/options/.
2. Create an advancedSettings.xml file with the following content:

<application xmlns:merge="https://github.com/devonfw/IDEasy/merge">
  <component name="AdvancedSettings">
    <option name="settings">
      <map>
        <entry merge:id="@key"
               key="bigger.font.in.project.view"
               value="true" />
        <entry key="documentation.components.enable.highlighting.of.links"
               value="true" />
        <entry key="ide.ui.non.modal.settings.window"
               value="true" />
      </map>
    </option>
  </component>
</application>

3. Run ide update
4. Open Intellij in a workspace
5. Verify that the Settings dialog opens as a tab in the editor instead of a modal window.
6. Open IntelliJ in another workspace/project and verify that the same setting is applied there as well.
7. Remove the following line from advancedSettings.xml:

 <entry key="ide.ui.non.modal.settings.window" value="true" />

8. ide update
9. check again for both workspaces and verify that the Settings dialog no longer opens as a tab in the editor, but as a modal dialog.

---

Checklist for this PR

Make sure everything is checked before merging this PR. For further info please also see
our DoD.

• When running mvn clean test locally all tests pass and build is successful
• PR title is of the form #«issue-id»: «brief summary» (e.g. #921: fixed setup.bat). If no issue ID exists, title only.
• PR top-level comment summarizes what has been done and contains link to addressed issue(s)
• PR and issue(s) have suitable labels
• Issue is set to In Progress and assigned to you or there is no issue (might happen for very small PRs)
• You followed all coding conventions
• You have added the issue implemented by your PR in CHANGELOG.adoc unless issue is labeled
  with internal
• You have formulated clear instructions on how to test your contribution under "Testing instructions"

[CLAassistant]

All committers have signed the CLA.

[coveralls]

Coverage Report for CI Build 28702536973

Coverage decreased (-0.04%) to 71.789%

Details

• Coverage decreased (-0.04%) from the base build.
• Patch coverage: No coverable lines changed in this PR.
• 3 coverage regressions across 2 files.

Uncovered Changes

No uncovered changes found.

Coverage Regressions

3 previously-covered lines in 2 files lost coverage.

File	Lines Losing Coverage	Coverage
com/devonfw/tools/ide/version/VersionSegment.java	2	89.5%
com/devonfw/tools/ide/tool/ide/IdeToolCommandlet.java	1	78.33%

---

Coverage Stats

Relevant Lines:	16300
Covered Lines:	12197
Line Coverage:	74.83%
Relevant Branches:	7308
Covered Branches:	4751
Branch Coverage:	65.01%
Branches in Coverage %:	Yes
Coverage Strength:	3.17 hits per line

---

💛 - Coveralls

[laert-ll]

Apologies for the PR review delay, there was quite a bit of confusion from my side about this issue.

The original bug report stated that the settings stored in ~/.ide/intellij\workspace\update\.intellij\config\options\advancedSettings.xml were not being used by the ide globally (e.g. independently by other instances of the ide in other projects). However, when testing it locally, this was exactly the path which worked:

Intellij default font size:

Then I copied the editor-font.xml setting file from ~/projects/IDEasy/workspaces/main/.intellij/config/options/ to ~/.ide/intellij/workspace/update/.intellij/config/options/ and edited it manually to another value (14).

Then, I opened intellij from another project folder and checked that the manually changed font settings were applied:

After digging a bit more, it seemed like the #1063 bug report was probably due to an IDE version being tested which was not up to date. This was reported under IDEasy: 2025.01.001-beta-01_21_02-SNAPSHOT (21/01/2025), which predates #1010 (07/02/2025) where this functionality was implemented.

So ~/.ide/settings/«ide»/workspace/ is not the correct path to place global ide settings, the settings subfolder applies to plugins (~/.ide/settings/<ide>/plugins/), not to workspace configuration. However it would still be nice to have some more elaborate clarification in the documentation on where the file settings should be placed instead (~/.ide/<ide>/workspace/).