Document buildTransitive scenarios

[nkolev92]

Document the buildtransitive scenarios:

#6091

[karann-msft]

@rrelyea can we have this assigned? I can work with them to get it documented.

[ericsampson]

Is this still undocumented?

[ericsampson]

@nkolev92 any chance of getting this documented? :)

[nkolev92]

cc @JonDouglas @aortiz-msft

@JonDouglas maybe this can part of the docs bash?

[j0shuams]

Any updates on this? I think some more documentation on this would help me with my current situation. I'm writing a package (call it Library) that uses CsWinRT. For an app consuming my Library's nupkg, it needs certain CsWinRT dlls. Using targets and buildTransitive, I am able to get all dlls into the nupkg, and 4/5 dlls copied to the output directory of the consuming app. But one is failing to be found for copying, and I'm grinding through binlogs to figure it out. Any documentation/samples would be very helpful!

[JonDouglas]

Sorry no update until just reading this comment. We never got to this for the last couple doc bashes.

If I understand this correctly, we want to document buildTransitive based on the spec:

https://github.com/NuGet/Home/wiki/Allow-package--authors-to-define-build-assets-transitive-behavior

There are a number of scenarios on the spec, but no actual examples. I'll look into it after the other p1 doc-bash issue.

[ericsampson]

Thanks @JonDouglas. One question though is how much of the spec actually got implemented, and if there are any differences in behavior/syntax etc… Seems risky to create docs based on an original spec and not the actual implementation

[xiaomi7732]

I have a related issue filed here: microsoft/ApplicationInsights-Profiler-AspNetCore#173. And I ran into 6091, which is closed but it is not very clear, is the feature actually implemented? And if it is, how to use it?