dotnet / command-line-api

Command line parsing, invocation, and rendering of terminal output.
https://github.com/dotnet/command-line-api/wiki
MIT License
3.38k stars 381 forks source link

Powderhouse extensibility overview doc #2371

Closed mhutch closed 5 months ago

mhutch commented 6 months ago

The shape of some of the APIs has been superseded since this was originally written but the conceptual overview is still useful

KathleenDollard commented 6 months ago

I think we should consider a different file layout for proposals.

If we create a "Powderhouse" folder in docs, or we create a "Proposals" folder under the root or in docs, it will be easier to find documents like this. I plan to switch to markdown docs for the proposals I have been putting into issues, where they seem big enough.

Also, I think we should consider a corresponding issue for proposals where we can get feedback and record changes until the document is updated.

I'm doing this for the proposal I am putting up today, so we can resolve the layout in discussing these PRs.

KathleenDollard commented 6 months ago

Also, what kind of review do you want on this? I have been working with this doc and I think implemented the annotations as described, but I now have a more depth on the pipeline. So, I approve, but have not reviewed it in detail now.