flightplan icon indicating copy to clipboard operation
flightplan copied to clipboard

Allow for task descriptions

Open martinpeck opened this issue 9 years ago • 3 comments

In a similar way to how rake allows desc statements to describe tasks, it would be great if flightplan supported some way to give description text when printing the results of fly --T.

This would allow task names to remain terse enough to be typed, while providing more information to those who are inspecting the list of tasks provided by a flightplan.js.

martinpeck avatar Aug 11 '16 12:08 martinpeck

Pull requests are welcome.

pstadler avatar Aug 11 '16 14:08 pstadler

Sure,. will take a look....do you have any pointers as to ways this might be integrated (or approaches to avoid)?

martinpeck avatar Aug 11 '16 17:08 martinpeck

Do you think that the description should be defined as another param passed to .local or .remote...

plan.local("task", "description of task", function(local) {
  /* noop */
});

... or, do you think that using a dictionary if you want to specify a name and a description is better...

plan.local({ name : "task", description : "description of task" }, function(local) {
    /* noop */
});

The dictionary would be easier to implement, and makes back compatibility easier. The code would inspect the first parameter, as it does today, but it would additionally compare it to a dictionary.

Thoughts?

martinpeck avatar Sep 13 '16 21:09 martinpeck