Skip to content

Commit c905326

Browse files
authored
Clarify NuGet Client SDK support policy (#3197)
1 parent e1e282d commit c905326

File tree

2 files changed

+17
-0
lines changed

2 files changed

+17
-0
lines changed

docs/reference/NuGet-Client-SDK.md

Lines changed: 8 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -32,6 +32,14 @@ You can find the source code for these packages in the [NuGet/NuGet.Client](http
3232
> [!Note]
3333
> For documentation on the NuGet server protocol, please refer to the [NuGet Server API](~/api/overview.md).
3434
35+
## Support policy
36+
37+
All security bugs should be reported to the Microsoft Security Response Center (MSRC) at [https://aka.ms/opensource/security/create-report].
38+
Also see the [security policy in the NuGet.Client repo](https://github.com/NuGet/NuGet.Client/blob/dev/SECURITY.md).
39+
40+
We do not guarantee API stability, as our team's responsibility is tooling, not libraries.
41+
See [https://github.com/NuGet/NuGet.Client/blob/dev/docs/nuget-sdk.md] for more information.
42+
3543
## NuGet.Protocol
3644

3745
Install the `NuGet.Protocol` package to interact with HTTP and folder-based NuGet package feeds:

docs/visual-studio-extensibility/nuget-api-in-visual-studio.md

Lines changed: 9 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -19,6 +19,15 @@ NuGet's product follows Visual Studio's version, but is 11.0 versions behind. Fo
1919

2020
Starting from Visual Studio 17.1, NuGet's Visual Studio extensibility API packages match the version of Visual Studio that the APIs are targeting. For example, NuGet.VisualStudio and NuGet.VisualStudio.Contracts package version 17.1.0 should be used when your extension targets Visual Studio 17.1 and higher. In Visual Studio 17.0 and earlier, NuGet's package versions are the same as NuGet's product version. For example, if your extension targets Visual Studio 2022 version 17.0, you should use version 6.0 of NuGet's Visual Studio extensibility packages.
2121

22+
## NuGet Client SDK in Visual Studio Extensions
23+
24+
Only the APIs in `NuGet.VisualStudio` and `NuGet.VisualStudio.Contracts` are supported in Visual Studio extensions.
25+
NuGet provides binding redirects for these assemblies, so these assemblies do not need to be included in your extension.
26+
27+
Using NuGet Client SDK packages, for example `NuGet.Protocol`, is not supported in Visual Studio extensions.
28+
NuGet does not provide binding redirects for these assemblies.
29+
See [the NuGet Client SDK support policy](../reference/NuGet-Client-SDK.md#support-policy) for more information.
30+
2231
## Services List
2332

2433
### Brokered Services

0 commit comments

Comments
 (0)