Document machine readable json output for dotnet list package report

[erdembayar]

Fixes: https://github.com/NuGet/docs.microsoft.com-nuget/issues/2922
Related to: dotnet/sdk#29367, NuGet/Home#7752

Spec is here. New command option can be used like below:
dotnet list package --format json
dotnet list package --format json --output-version 1

!!! Don't merge before we verify it's available in GA sdk version.

[nkolev92]

Do we want to document the format somehow/somewhere?

[erdembayar]

Do we want to document the format somehow/somewhere?

Do you mean something like blog post which explains usage in detail?

[nkolev92]

Do we want to document the format somehow/somewhere?

Do you mean something like blog post which explains usage in detail?

Not really. More of a schema for the file somewhere that's not our designs.
People would need to know how to parse things.

[tdykstra]

LGTM, one suggestion

[BillWagner]

Tom's comments have all been addressed.

I'll now.

[erdembayar]

@BillWagner
My change is going into .NET sdk 7.0.2xx not in .NET sdk 7.0.102, it looks like this PR merged prematurely, not causing some confusion. Could we revert this one? I should have specified it's .NET sdk 7.0.2xx version in my description. I didn't know it went live this soon.

[tdykstra]

Do we want to document the format somehow/somewhere?

Do you mean something like blog post which explains usage in detail?

Not really. More of a schema for the file somewhere that's not our designs. People would need to know how to parse things.

@nkolev92 @erdembayar We have an issue now asking for the format (#38022) is that information available somewhere?

[nkolev92]

We have a tracking issue for that (it was internal, so I moved it to an external one) NuGet/Home#13503.

The source of truth is https://github.com/NuGet/Home/blob/dev/proposed/2022/DotnetListPackageMachineReadableJsonOutput.md.
It's not quite written ina schema way, but it contains all the examples.

[Marusyk]

@nkolev92
https://github.com/NuGet/Home/blob/dev/proposed/2022/DotnetListPackageMachineReadableJsonOutput.md

[erdembayar]

@nkolev92 https://github.com/NuGet/Home/blob/dev/proposed/2022/DotnetListPackageMachineReadableJsonOutput.md

Someone recently moved the specs, use new link: https://github.com/NuGet/Home/blob/dev/accepted/2022/DotnetListPackageMachineReadableJsonOutput.md