Add docs for the 'dotnet nuget why' command

docs/core/tools/dotnet-nuget-why.md

@@ -0,0 +1,65 @@
+---
+title: dotnet nuget why command
+description: Shows the dependency graph for a particular package for a given project or solution.
+author: advay26
+ms.date: 05/30/2024
+---
+# dotnet nuget why
+
+**This article applies to:** ✔️ .NET 8.0.4xx SDK and later versions
+
+## Name
+
+`dotnet nuget why` - Shows the dependency graph for a particular package.
+
+## Synopsis
+
+```dotnetcli
+dotnet nuget why <PROJECT|SOLUTION> <PACKAGE> [-f|--framework <FRAMEWORK>]
+
+dotnet nuget why -h|--help
+```
+
+## Description
+
+The `dotnet nuget why` command shows the dependency graph for a particular package for a given project or solution.
+
+## Arguments
+
+- **`PROJECT|SOLUTION`**
+
+  A path to a project file, solution file, or directory. If a directory is specified, the command searches the directory for a project or solution file. If more than one project or solution is found, an error is thrown.
+
+- **`PACKAGE`**
+
+  The package name to lookup in the dependency graph.
+
+## Options
+
+- **`-f|--framework <FRAMEWORK>`**
+
+    The target framework(s) for which dependency graphs are shown. You can pass multiple `--framework` options to see graphs for more than one framework.
+
+[!INCLUDE [help](../../../includes/cli-help.md)]
+
+## Examples
+
+- Show the dependency graph for the package "System.Text.Json" for a given solution:
+
+    ```dotnetcli
+    dotnet nuget why .\DotnetNuGetWhyPackage.sln System.Text.Json
+    ```
+
+    ![Example: Solution with multiple projects](media/dotnet-nuget-why/dotnet-nuget-why-solution-with-multiple-projects.png)
+
+- Show the dependency graph for the package "System.Text.Json" for a single project:
+
+    ```dotnetcli
+    dotnet nuget why .\DotnetNuGetWhyPackage.csproj System.Text.Json
+    ```
+
+- Show the dependency graph for a specific target framework:
+
+    ```dotnetcli
+    dotnet nuget why .\DotnetNuGetWhyPackage.csproj System.Text.Json --framework net6.0
+    ```

docs/core/tools/index.md

@@ -60,6 +60,7 @@ The following commands are installed by default:
 - [`nuget trust`](dotnet-nuget-trust.md) (Available since .NET 5 SDK)
 - [`nuget sign`](dotnet-nuget-sign.md) (Available since .NET 6 SDK)
 - [`package search`](dotnet-package-search.md) (Available since .NET 8.0.2xx SDK)
+- [`nuget why`](dotnet-nuget-why.md) (Available since .NET 8.0.4xx SDK)
 
 ### Workload management commands