From 7f5256b788ab9b02d64e61b3d3b969303d52f133 Mon Sep 17 00:00:00 2001
From: wuyangfan <yangfan.wu@succaiss.com>
Date: Mon, 25 May 2026 13:41:50 +0800
Subject: [PATCH] docs: clarify PopupRenderPosition usage in ASP.NET Core

Document that AddMiniProfiler configuration alone does not render the
popup; the layout must include the mini-profiler tag helper or an
equivalent RenderIncludes call.

Fixes #632

Co-authored-by: Cursor <cursoragent@cursor.com>
---
 src/MiniProfiler.Shared/Internal/MiniProfilerBaseOptions.cs | 5 ++++-
 1 file changed, 4 insertions(+), 1 deletion(-)

diff --git a/src/MiniProfiler.Shared/Internal/MiniProfilerBaseOptions.cs b/src/MiniProfiler.Shared/Internal/MiniProfilerBaseOptions.cs
index 6f2b65f6..12c4fb6a 100644
--- a/src/MiniProfiler.Shared/Internal/MiniProfilerBaseOptions.cs
+++ b/src/MiniProfiler.Shared/Internal/MiniProfilerBaseOptions.cs
@@ -124,7 +124,10 @@ public class MiniProfilerBaseOptions
 
         /// <summary>
         /// Dictates on which side of the page the profiler popup button is displayed; defaults to left.
-        /// For a per-page override you can use .RenderIncludes(position: RenderPosition.Left/Right)
+        /// For a per-page override you can use .RenderIncludes(position: RenderPosition.Left/Right).
+        /// In ASP.NET Core this setting is applied when rendering the <c>&lt;mini-profiler /&gt;</c> tag helper
+        /// (or an equivalent <c>RenderIncludes</c> call) in the layout; configuring it in
+        /// <c>AddMiniProfiler</c> alone does not render the UI.
         /// </summary>
         public RenderPosition PopupRenderPosition { get; set; } = RenderPosition.Left;