diff --git a/website/docs/nuget.md b/website/docs/nuget.md
new file mode 100644
index 0000000000000000000000000000000000000000..8bf91e5b0993081499fefeafa2fdb4baf7fd24bc
--- /dev/null
+++ b/website/docs/nuget.md
@@ -0,0 +1,29 @@
+---
+title: Nuget (.NET)
+description: Nuget (.NET) dependencies support in Renovate
+---
+
+# Nuget
+
+Renovate supports upgrading dependencies in `.csproj` files.
+
+## Version Support
+
+Only SDK-style `.csproj` files are currently supported. By default, this includes:
+
+- .NET Core 1.0 and above
+- .NET Standard class libraries
+- Any `.csproj` in the SDK-style syntax
+
+To convert your .NET Framework .csproj into an SDK-style project, one can follow the [following guide](https://natemcmaster.com/blog/2017/03/09/vs2015-to-vs2017-upgrade/).
+
+## How It Works
+
+1.  Renovate will search each repository for any files with a `.csproj` extension.
+2.  Existing dependencies will be extracted from `<PackageReference>` tags
+3.  Renovate will look up the latest version on [nuget.org](https://nuget.org) to determine if any upgrades are available
+4.  If the source package includes a GitHub URL as its source, and has either a "changelog" file or uses GitHub releases, then Release Notes for each version will be embedded in the generated PR.
+
+## Future work
+
+Contributions and/or feature requests are welcome to support more patterns or additional use cases.