[ https://issues.jboss.org/browse/WFCORE-2283?page=com.atlassian.jira.plugi... ] Jean-Francois Denise commented on WFCORE-2283: ---------------------------------------------- Hi [~weeks.c], we are proposing here a way to help Wildly Command Line (CLI) users to identify the required arguments when completing a management operation. 1) One way would be to "tag" exposed arguments to explicit their nature (required vs optional) (eg: asterisk for mandatory, brackets for optional, colouring or any other syntax element). 2) Another way would be to filter arguments. First expose required arguments then, once the operation contains all the mandatory ones, expose optional ones. The second way has today my preference (not a lot of practice of it, just raw prototyping for now): - No syntax marker to decode ("what this '*' means" kind of question) - No confusion between what the completion exposes and what you get when selecting one of these items (tag being removed in the selected argument). - No need for colouring (that color blinds would not take benefit of). Color seems to me not a good idea (specially in a command line/terminal context). - More drive, the user is driven by the completer to choose arguments. - Reduced amount of content exposed to the user. - Allow for optimised cases. This is the case of a single required argument that would be automatically inlined when completing for the first time, the completer would then propose the list of optional arguments (if any). - This is in line with some other part of the CLI where similar filtering is applied to expose command options (as opposed to operation arguments discussed there). With this approach we are loosing the flat list (that contains all arguments) that can be seen as helpful to discover the whole set of arguments in a single <TAB> action when you have both required and optional arguments. In this case you will discover them all but in 2 steps. Users could think that there are ONLY required attributes although the right way to properly discover the set or operation arguments is by using the help command. help describes the operation synopsis that contains details on required/optional arguments (description and typing). help extract: help /subsystem=logging/logger=sun.rmi:list-add SYNOPSIS list-add(name=<a string>, [index=<an integer>], [value=<a string>]) If you are interested by discussing this topic, we could exchange more on it. Thanks. JF -- This message was sent by Atlassian JIRA (v7.2.3#72005)