dotnet / dotnet/command-line-api

Where can I find updated documentation?

Open
#2,231 7 comments 7 reactions 0 assignees View on GitHub
Area-Documentation bug
Dominant language
C#
Stars
3.7k
Forks
428
PR merge metrics
No merged PRs in 30d

Description

I'm currently using the latest build on nuget.org (2.0.0-beta4.22272.1). This version is over a year old and thus is missing several bug fixes.

The bug fix I need specifically is #2212, so I attempted to use a newer version from the daily builds feed.

However, I ran into many issues trying to migrate to the version due to the significant API changes between the two versions. I managed to work some of it out, but I have not been able to find any documentation at all for the new version. Even just a list of breaking changes would help, but the complete lack of documentation has made migration next to impossible.

I still haven't been able to work out how to migrate the following:
- Custom binders using `BinderBase` - `BinderBase` doesn't exist any more, and I can't find a replacement
- `RootCommand.SetHandler` - again, no longer exists
- `RootCommand.Invoke`/`RootCommand.InvokeAsync` - also no longer exists

If documentation does exist for the new version, this should really be added to the main README. It would also be very helpful to have some information around migration, e.g. a list of breaking changes at a minimum.

Contributor guide

Open the contributing guide

Assessment

This issue has not been assessed yet.

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.