Make icd more usable

[maybeec]

Feature idea

As a user, I want to easily navigate to IDEs and between IDEs in my console. I was notified that there is a command icd, which can be used. I was very happy, but 1. it did not match my expectations and 2. it's not documented.
Thus, I am not clear what this command is about.
My expectation and thus most probably a feature request is:

I expected icd command to work as follows:

• if used, it will check for the parameter (IDE name), whether there is an IDE with the given name
  • if there is NO IDE with the given name, it will reply with the same message and will not do anything
  • if there is an IDE with the given name
    • if there is a just one workspace (e.g. "main") in the given IDE, the command will navigate directly to <IDE-Path>/workspaces/main
    • if there are multiple workspaces available in the IDE, it will navigate to <IDE-Path>/workspaces

Additional context

If icd is meant to serve any value for users, it should be somehow part of the usage documentation (help) to enable better usability for non-internals as well.

[hohwille]

Thanks for your feedback.

1. it did not match my expectations

we are sorry to hear that.

2. it's not documented.

Before claiming things like that you could type icd in the github search of our repo:
https://github.com/devonfw/IDEasy/blob/main/documentation/cli.adoc#icd

You can also type icd --help 😄

We designed icd as a drop-in replacement for cd so it behaves and can be used just like cd but offers nice additional features.
Instead of icd myproject you need to type icd -p myproject.

if there is a just one workspace (e.g. "main") in the given IDE, the command will navigate directly to /workspaces/main

Use icd -p myproject -w or icd -p myproject -w myworkspace.

I hope you can live with our design choice once it is clear now.
We are planning auto-completion for icd but currently have other priorities and too little resources for low prio stories.

Let us know if we can close this issue as invalid.