From 825d2666cd88993304cb35bec8971425ce79e3a3 Mon Sep 17 00:00:00 2001
From: Konrad Malik <konrad.malik@gmail.com>
Date: Tue, 10 Dec 2024 17:35:38 +0100
Subject: [PATCH] docs(nuget): add info about nested nuget ignorePaths (#33020)

---
 docs/usage/nuget.md | 17 +++++++++++++++++
 1 file changed, 17 insertions(+)

diff --git a/docs/usage/nuget.md b/docs/usage/nuget.md
index 67c8409dcd4b62..ef827088a82272 100644
--- a/docs/usage/nuget.md
+++ b/docs/usage/nuget.md
@@ -130,6 +130,23 @@ If you use Azure DevOps:
     The username of the PAT must match the username of the _user of the PAT_.
     The generated `nuget.config` forces the basic authentication, which cannot be overridden externally!
 
+## Ignoring package files when using presets
+
+Because `nuget` manager has a dedicated `ignorePaths` entry in the `:ignoreModulesAndTests` preset, if you're using any presets that extend it (like `config:recommended`), you need to put your `ignorePaths` inside the `nuget` section for it to be merged.
+For example:
+
+```json
+{
+  "$schema": "https://docs.renovatebot.com/renovate-schema.json",
+  "extends": ["config:recommended"],
+  "nuget": {
+    "ignorePaths": ["IgnoreThisPackage/**"]
+  }
+}
+```
+
+Otherwise, all `nuget.ignorePaths` values in `:ignoreModulesAndTests` will override values you put inside `ignorePaths` at the top-level config.
+
 ## Future work
 
 We welcome contributions or feature requests to support more patterns or use cases.