cake-build/cake
GitHub で見るProvide ability to create documentation for Arguments similar to Tasks
Open
#1,708 opened on 2017年7月31日
FeatureHelp wantedUp-for-grabs
Repository metrics
- Stars
- (3,742 stars)
- PR merge metrics
- (平均マージ 1d 1h) (30d で 25 merged PRs)
説明
Hi,
as described in this SO question: https://stackoverflow.com/questions/45413524/how-can-cake-build-arguments-be-documented
it would be great to be able to add documentation for Arguments as it is currently possible for Tasks by using the Description("...") method.
So e.g. executing the build script with the -showdescription parameter could show the described targets as well as the available arguments with an optional help text:
For registering a help text with an argument an additional parameter could be introduced to the already existing Argument methods. E.g.
Argument("someArgument", "x", "Argument description. Can be multiline, maybe.")
Or some other way:
var argValue = ArgumentBuilder("someArgument", "x")
.WithHelpText("Argument description. Can be multiline, maybe.")
.GetValue()
What do you think?
Best regards, Philipp