Documentation of functions

[hohwille]

As a new devonfw-ide developer, I want to get some documentation about the functions so that I can understand easier which functions are available, what they do and how to use them without digging and reverse-engineering the code.

The functions are complex and long (>1000 lines). It is not properly documented and adding extensive documentation here might have some downsides as the script has to be parsed by bash all the time and extensive comments would massively increase the file length and size.
Therefore we instead want to add a documentation/functions.asciidoc file as documentation to functions.
Here we should have a heading for each function with a description of the function (e.g. doInstall) in a common format (e.g. using a table or numbered list points for parameters, etc.).
As this is quite some work, it would IMHO be a good idea to first start with a single function as example and then introduce the result to the entire team to get feedback before documenting all other functions in the same way.
This story is slightly related to #729

[hohwille]

See #729