From f678a85b9ef83366ea868a0cc5c515a835c15cad Mon Sep 17 00:00:00 2001
From: peereflits <peereflits@live.com>
Date: Fri, 16 Jan 2026 11:33:55 +0100
Subject: [PATCH 1/3] docs: provided English translations

---
 .../ContextMenu/ContextMenu.razor.cs          | 37 +++++++++++--------
 .../ContextMenu/ContextMenuDivider.cs         | 12 +++---
 .../Components/ContextMenu/ContextMenuItem.cs | 25 ++++++++-----
 .../ContextMenu/ContextMenuTrigger.cs         | 27 +++++++++-----
 .../ContextMenu/ContextMenuZone.razor.cs      | 22 ++++++-----
 .../ContextMenu/IContextMenuItem.cs           |  8 +++-
 6 files changed, 81 insertions(+), 50 deletions(-)

diff --git a/src/BootstrapBlazor/Components/ContextMenu/ContextMenu.razor.cs b/src/BootstrapBlazor/Components/ContextMenu/ContextMenu.razor.cs
index 7092087e27a..a0988774bf4 100644
--- a/src/BootstrapBlazor/Components/ContextMenu/ContextMenu.razor.cs
+++ b/src/BootstrapBlazor/Components/ContextMenu/ContextMenu.razor.cs
@@ -1,4 +1,4 @@
-// Licensed to the .NET Foundation under one or more agreements.
+// Licensed to the .NET Foundation under one or more agreements.
 // The .NET Foundation licenses this file to you under the Apache 2.0 License
 // See the LICENSE file in the project root for more information.
 // Maintainer: Argo Zhang(argo@live.ca) Website: https://www.blazor.zone
@@ -8,24 +8,28 @@
 namespace BootstrapBlazor.Components;
 
 /// <summary>
-/// ContextMenu 组件
+/// <para lang="zh">ContextMenu 组件</para>
+/// <para lang="en">ContextMenu component</para>
 /// </summary>
 public partial class ContextMenu
 {
     /// <summary>
-    /// 获得/设置 是否显示阴影 默认 true
+    /// <para lang="zh">获得/设置 是否显示阴影 默认 true</para>
+    /// <para lang="en">Gets or sets whether to show shadow. Default is true.</para>
     /// </summary>
     [Parameter]
     public bool ShowShadow { get; set; } = true;
 
     /// <summary>
-    /// 获得/设置 弹出前回调方法 默认 null
+    /// <para lang="zh">获得/设置 弹出前回调方法 默认 null</para>
+    /// <para lang="en">Gets or sets the callback before showing the context menu. Default is null.</para>
     /// </summary>
     [Parameter]
     public Func<object?, Task>? OnBeforeShowCallback { get; set; }
 
     /// <summary>
-    /// 获得/设置 子组件
+    /// <para lang="zh">获得/设置 子组件</para>
+    /// <para lang="en">Gets or sets the child content.</para>
     /// </summary>
     [Parameter]
     public RenderFragment? ChildContent { get; set; }
@@ -70,8 +74,8 @@ protected override void OnInitialized()
     /// <summary>
     /// <inheritdoc/>
     /// </summary>
-    /// <param name="firstRender"></param>
-    /// <returns></returns>
+    /// <param name="firstRender"><para lang="zh">是否首次渲染</para><para lang="en">Whether this is the first render</para></param>
+    /// <returns><para lang="zh">异步任务</para><para lang="en">An asynchronous task</para></returns>
     protected override async Task OnAfterRenderAsync(bool firstRender)
     {
         await base.OnAfterRenderAsync(firstRender);
@@ -84,11 +88,12 @@ protected override async Task OnAfterRenderAsync(bool firstRender)
     }
 
     /// <summary>
-    /// 弹出 ContextMenu
+    /// <para lang="zh">弹出 ContextMenu</para>
+    /// <para lang="en">Show the ContextMenu</para>
     /// </summary>
-    /// <param name="args"></param>
-    /// <param name="contextItem"></param>
-    /// <returns></returns>
+    /// <param name="args"><para lang="zh">鼠标事件参数</para><para lang="en">Mouse event arguments</para></param>
+    /// <param name="contextItem"><para lang="zh">上下文项</para><para lang="en">Context item</para></param>
+    /// <returns><para lang="zh">异步任务</para><para lang="en">An asynchronous task</para></returns>
     internal async Task Show(MouseEventArgs args, object? contextItem)
     {
         _contextItem = contextItem;
@@ -109,14 +114,16 @@ private async Task OnClickItem(ContextMenuItem item)
     }
 
     /// <summary>
-    /// 增加 ContextMenuItem 方法
+    /// <para lang="zh">增加 ContextMenuItem 方法</para>
+    /// <para lang="en">Add a ContextMenuItem.</para>
     /// </summary>
-    /// <param name="item"></param>
+    /// <param name="item"><para lang="zh">要添加的项</para><para lang="en">The item to add</para></param>
     internal void AddItem(IContextMenuItem item) => _contextMenuItems.Add(item);
 
     /// <summary>
-    /// 移除 ContextMenuItem 方法
+    /// <para lang="zh">移除 ContextMenuItem 方法</para>
+    /// <para lang="en">Remove a ContextMenuItem.</para>
     /// </summary>
-    /// <param name="item"></param>
+    /// <param name="item"><para lang="zh">要移除的项</para><para lang="en">The item to remove</para></param>
     internal void RemoveItem(IContextMenuItem item) => _contextMenuItems.Remove(item);
 }
diff --git a/src/BootstrapBlazor/Components/ContextMenu/ContextMenuDivider.cs b/src/BootstrapBlazor/Components/ContextMenu/ContextMenuDivider.cs
index 821116c6d15..2bb0887727f 100644
--- a/src/BootstrapBlazor/Components/ContextMenu/ContextMenuDivider.cs
+++ b/src/BootstrapBlazor/Components/ContextMenu/ContextMenuDivider.cs
@@ -1,4 +1,4 @@
-// Licensed to the .NET Foundation under one or more agreements.
+// Licensed to the .NET Foundation under one or more agreements.
 // The .NET Foundation licenses this file to you under the Apache 2.0 License
 // See the LICENSE file in the project root for more information.
 // Maintainer: Argo Zhang(argo@live.ca) Website: https://www.blazor.zone
@@ -8,7 +8,8 @@
 namespace BootstrapBlazor.Components;
 
 /// <summary>
-/// ContextMenuDivider 组件
+/// <para lang="zh">ContextMenuDivider 组件</para>
+/// <para lang="en">ContextMenuDivider component</para>
 /// </summary>
 public class ContextMenuDivider : Divider, IContextMenuItem, IDisposable
 {
@@ -29,15 +30,16 @@ protected override void OnInitialized()
     /// <summary>
     /// <inheritdoc/>
     /// </summary>
-    /// <param name="builder"></param>
+    /// <param name="builder"><para lang="zh">渲染树生成器</para><para lang="en">The render tree builder</para></param>
     protected override void BuildRenderTree(RenderTreeBuilder builder) { }
 
     private bool disposedValue;
 
     /// <summary>
-    /// 释放资源方法
+    /// <para lang="zh">释放资源方法</para>
+    /// <para lang="en">Method to release resources.</para>
     /// </summary>
-    /// <param name="disposing"></param>
+    /// <param name="disposing"><para lang="zh">是否释放托管资源</para><para lang="en">Whether to release managed resources</para></param>
     protected virtual void Dispose(bool disposing)
     {
         if (!disposedValue)
diff --git a/src/BootstrapBlazor/Components/ContextMenu/ContextMenuItem.cs b/src/BootstrapBlazor/Components/ContextMenu/ContextMenuItem.cs
index f811f06fe3e..c07478c47eb 100644
--- a/src/BootstrapBlazor/Components/ContextMenu/ContextMenuItem.cs
+++ b/src/BootstrapBlazor/Components/ContextMenu/ContextMenuItem.cs
@@ -1,4 +1,4 @@
-// Licensed to the .NET Foundation under one or more agreements.
+// Licensed to the .NET Foundation under one or more agreements.
 // The .NET Foundation licenses this file to you under the Apache 2.0 License
 // See the LICENSE file in the project root for more information.
 // Maintainer: Argo Zhang(argo@live.ca) Website: https://www.blazor.zone
@@ -6,36 +6,42 @@
 namespace BootstrapBlazor.Components;
 
 /// <summary>
-/// ContextMenuItem 类
+/// <para lang="zh">ContextMenuItem 类</para>
+/// <para lang="en">ContextMenuItem class</para>
 /// </summary>
 public class ContextMenuItem : ComponentBase, IContextMenuItem, IDisposable
 {
     /// <summary>
-    /// 获得/设置 显示文本
+    /// <para lang="zh">获得/设置 显示文本</para>
+    /// <para lang="en">The text to display.</para>
     /// </summary>
     [Parameter]
     public string? Text { get; set; }
 
     /// <summary>
-    /// 获得/设置 图标
+    /// <para lang="zh">获得/设置 图标</para>
+    /// <para lang="en">The icon to display.</para>
     /// </summary>
     [Parameter]
     public string? Icon { get; set; }
 
     /// <summary>
-    /// 获得/设置 是否被禁用 默认 false 优先级低于 <see cref="OnDisabledCallback"/>
+    /// <para lang="zh">获得/设置 是否被禁用 默认 false 优先级低于 <see cref="OnDisabledCallback"/></para>
+    /// <para lang="en">Gets or sets whether the item is disabled. Default is false. Lower priority than <see cref="OnDisabledCallback"/>.</para>
     /// </summary>
     [Parameter]
     public bool Disabled { get; set; }
 
     /// <summary>
-    /// 获得/设置 是否被禁用回调方法 默认 null 优先级高于 <see cref="Disabled"/>
+    /// <para lang="zh">获得/设置 是否被禁用回调方法 默认 null 优先级高于 <see cref="Disabled"/></para>
+    /// <para lang="en">Gets or sets the callback to determine if the item is disabled. Default is null. Higher priority than <see cref="Disabled"/>.</para>
     /// </summary>
     [Parameter]
     public Func<ContextMenuItem, object?, bool>? OnDisabledCallback { get; set; }
 
     /// <summary>
-    /// 获得/设置 点击回调方法 默认 null
+    /// <para lang="zh">获得/设置 点击回调方法 默认 null</para>
+    /// <para lang="en">Gets or sets the click callback. Default is null.</para>
     /// </summary>
     [Parameter]
     public Func<ContextMenuItem, object?, Task>? OnClick { get; set; }
@@ -57,9 +63,10 @@ protected override void OnInitialized()
     private bool disposedValue;
 
     /// <summary>
-    /// 释放资源方法
+    /// <para lang="zh">释放资源方法</para>
+    /// <para lang="en">Method to release resources.</para>
     /// </summary>
-    /// <param name="disposing"></param>
+    /// <param name="disposing"><para lang="zh">是否释放托管资源</para><para lang="en">Whether to release managed resources</para></param>
     protected virtual void Dispose(bool disposing)
     {
         if (!disposedValue)
diff --git a/src/BootstrapBlazor/Components/ContextMenu/ContextMenuTrigger.cs b/src/BootstrapBlazor/Components/ContextMenu/ContextMenuTrigger.cs
index 256731b3533..12c54488790 100644
--- a/src/BootstrapBlazor/Components/ContextMenu/ContextMenuTrigger.cs
+++ b/src/BootstrapBlazor/Components/ContextMenu/ContextMenuTrigger.cs
@@ -9,24 +9,28 @@
 namespace BootstrapBlazor.Components;
 
 /// <summary>
-/// ContextMenuTrigger 组件
+/// <para lang="zh">ContextMenuTrigger 组件</para>
+/// <para lang="en">ContextMenuTrigger component</para>
 /// </summary>
 public class ContextMenuTrigger : BootstrapComponentBase
 {
     /// <summary>
-    /// 获得/设置 子组件
+    /// <para lang="zh">获得/设置 子组件</para>
+    /// <para lang="en">Gets or sets the child content.</para>
     /// </summary>
     [Parameter]
     public RenderFragment? ChildContent { get; set; }
 
     /// <summary>
-    /// 获得/设置 包裹组件 TagName 默认为 div
+    /// <para lang="zh">获得/设置 包裹组件 TagName 默认为 div</para>
+    /// <para lang="en">Gets or sets the wrapper component tag name. Default is div.</para>
     /// </summary>
     [Parameter]
     public string WrapperTag { get; set; } = "div";
 
     /// <summary>
-    /// 获得/设置 上下文数据
+    /// <para lang="zh">获得/设置 上下文数据</para>
+    /// <para lang="en">Gets or sets the context data.</para>
     /// </summary>
     [Parameter]
     public object? ContextItem { get; set; }
@@ -36,8 +40,8 @@ public class ContextMenuTrigger : BootstrapComponentBase
     private ContextMenuZone? ContextMenuZone { get; set; }
 
     /// <summary>
-    /// The timeout duration for touch events to trigger the context menu (in milliseconds).
-    /// Default is <see cref="ContextMenuOptions.OnTouchDelay"/> milliseconds. Must be greater than 0.
+    /// <para lang="zh">触摸事件触发菜单的超时时间（毫秒）。默认值为 <see cref="ContextMenuOptions.OnTouchDelay"/> 毫秒。必须大于 0。</para>
+    /// <para lang="en">The timeout duration for touch events to trigger the context menu (in milliseconds). Default is <see cref="ContextMenuOptions.OnTouchDelay"/> milliseconds. Must be greater than 0.</para>
     /// </summary>
     [Parameter]
     public int? OnTouchDelay { get; set; }
@@ -62,7 +66,7 @@ protected override void OnParametersSet()
     /// <summary>
     /// <inheritdoc/>
     /// </summary>
-    /// <param name="builder"></param>
+    /// <param name="builder"><para lang="zh">渲染树生成器</para><para lang="en">The render tree builder</para></param>
     protected override void BuildRenderTree(RenderTreeBuilder builder)
     {
         builder.OpenElement(0, WrapperTag);
@@ -77,18 +81,21 @@ protected override void BuildRenderTree(RenderTreeBuilder builder)
     }
 
     /// <summary>
-    /// 点击 ContextMenu 菜单项时触发
+    /// <para lang="zh">点击 ContextMenu 菜单项时触发</para>
+    /// <para lang="en">Triggered when a ContextMenu menu item is clicked.</para>
     /// </summary>
     [DynamicDependency(DynamicallyAccessedMemberTypes.PublicMethods, typeof(MouseEventArgs))]
     public Task OnContextMenu(MouseEventArgs args) => ContextMenuZone.OnContextMenu(args, ContextItem);
 
     /// <summary>
-    /// 是否触摸
+    /// <para lang="zh">是否触摸</para>
+    /// <para lang="en">Indicates whether touch has started.</para>
     /// </summary>
     public bool IsTouchStarted { get; private set; }
 
     /// <summary>
-    /// 触摸定时器工作指示
+    /// <para lang="zh">触摸定时器工作指示</para>
+    /// <para lang="en">Indicates whether the touch timer is working.</para>
     /// </summary>
     private bool IsBusy { get; set; }
 
diff --git a/src/BootstrapBlazor/Components/ContextMenu/ContextMenuZone.razor.cs b/src/BootstrapBlazor/Components/ContextMenu/ContextMenuZone.razor.cs
index b8deed10a9b..bd8cbff4c3a 100644
--- a/src/BootstrapBlazor/Components/ContextMenu/ContextMenuZone.razor.cs
+++ b/src/BootstrapBlazor/Components/ContextMenu/ContextMenuZone.razor.cs
@@ -1,4 +1,4 @@
-// Licensed to the .NET Foundation under one or more agreements.
+// Licensed to the .NET Foundation under one or more agreements.
 // The .NET Foundation licenses this file to you under the Apache 2.0 License
 // See the LICENSE file in the project root for more information.
 // Maintainer: Argo Zhang(argo@live.ca) Website: https://www.blazor.zone
@@ -8,12 +8,14 @@
 namespace BootstrapBlazor.Components;
 
 /// <summary>
-/// ContextMenuZone 组件
+/// <para lang="zh">ContextMenuZone 组件</para>
+/// <para lang="en">ContextMenuZone component</para>
 /// </summary>
 public partial class ContextMenuZone
 {
     /// <summary>
-    /// 获得/设置 子组件
+    /// <para lang="zh">获得/设置 子组件</para>
+    /// <para lang="en">Gets or sets the child content.</para>
     /// </summary>
     [Parameter]
     public RenderFragment? ChildContent { get; set; }
@@ -25,11 +27,12 @@ public partial class ContextMenuZone
         .Build();
 
     /// <summary>
-    /// Trigger 调用
+    /// <para lang="zh">Trigger 调用</para>
+    /// <para lang="en">Trigger call</para>
     /// </summary>
-    /// <param name="args"></param>
-    /// <param name="contextItem"></param>
-    /// <returns></returns>
+    /// <param name="args"><para lang="zh">鼠标事件参数</para><para lang="en">Mouse event arguments</para></param>
+    /// <param name="contextItem"><para lang="zh">上下文项</para><para lang="en">Context item</para></param>
+    /// <returns><para lang="zh">异步任务</para><para lang="en">An asynchronous task</para></returns>
     internal async Task OnContextMenu(MouseEventArgs args, object? contextItem)
     {
         // 弹出关联菜单
@@ -40,8 +43,9 @@ internal async Task OnContextMenu(MouseEventArgs args, object? contextItem)
     }
 
     /// <summary>
-    /// ContextMenu 组件调用
+    /// <para lang="zh">ContextMenu 组件调用</para>
+    /// <para lang="en">Called by the ContextMenu component</para>
     /// </summary>
-    /// <param name="contextMenu"></param>
+    /// <param name="contextMenu"><para lang="zh">要注册的 ContextMenu 组件</para><para lang="en">The ContextMenu component to register</para></param>
     internal void RegisterContextMenu(ContextMenu contextMenu) => _contextMenu = contextMenu;
 }
diff --git a/src/BootstrapBlazor/Components/ContextMenu/IContextMenuItem.cs b/src/BootstrapBlazor/Components/ContextMenu/IContextMenuItem.cs
index 3031c4429ed..756b415f446 100644
--- a/src/BootstrapBlazor/Components/ContextMenu/IContextMenuItem.cs
+++ b/src/BootstrapBlazor/Components/ContextMenu/IContextMenuItem.cs
@@ -1,13 +1,17 @@
-// Licensed to the .NET Foundation under one or more agreements.
+// Licensed to the .NET Foundation under one or more agreements.
 // The .NET Foundation licenses this file to you under the Apache 2.0 License
 // See the LICENSE file in the project root for more information.
 // Maintainer: Argo Zhang(argo@live.ca) Website: https://www.blazor.zone
 
+using static System.Net.WebRequestMethods;
+
 namespace BootstrapBlazor.Components;
 
 /// <summary>
-/// IContextMenuItem 接口
+/// <para lang="zh">IContextMenuItem 接口</para>
+/// <para lang="en">The interface for a menu item in a context menu.</para>
 /// </summary>
+/// <remarks>This is a <see href="https://en.wikipedia.org/wiki/Marker_interface_pattern">marker interface</see>.</remarks>
 public interface IContextMenuItem
 {
 

From 70573f55a4dd8e668fa5ed0608cb0870efe6eb28 Mon Sep 17 00:00:00 2001
From: peereflits <peereflits@live.com>
Date: Fri, 16 Jan 2026 12:38:40 +0100
Subject: [PATCH 2/3] docs: manual edit and improvement to the documentation

---
 .../ContextMenu/ContextMenu.razor.cs          | 47 +++++++++++--------
 .../ContextMenu/ContextMenuDivider.cs         | 14 ++----
 .../Components/ContextMenu/ContextMenuItem.cs | 17 ++++---
 .../ContextMenu/ContextMenuTrigger.cs         | 18 ++-----
 .../ContextMenu/ContextMenuZone.razor.cs      | 14 +++---
 5 files changed, 53 insertions(+), 57 deletions(-)

diff --git a/src/BootstrapBlazor/Components/ContextMenu/ContextMenu.razor.cs b/src/BootstrapBlazor/Components/ContextMenu/ContextMenu.razor.cs
index a0988774bf4..435c9576a69 100644
--- a/src/BootstrapBlazor/Components/ContextMenu/ContextMenu.razor.cs
+++ b/src/BootstrapBlazor/Components/ContextMenu/ContextMenu.razor.cs
@@ -9,27 +9,27 @@ namespace BootstrapBlazor.Components;
 
 /// <summary>
 /// <para lang="zh">ContextMenu 组件</para>
-/// <para lang="en">ContextMenu component</para>
+/// <para lang="en">A component that represents a context menu.</para>
 /// </summary>
 public partial class ContextMenu
 {
     /// <summary>
-    /// <para lang="zh">获得/设置 是否显示阴影 默认 true</para>
-    /// <para lang="en">Gets or sets whether to show shadow. Default is true.</para>
+    /// <para lang="zh">获得/设置 是否显示阴影 默认 <see langword="true" /></para>
+    /// <para lang="en">Flags whether to show a shadow around the context menu. Default is <see langword="true" />.</para>
     /// </summary>
     [Parameter]
     public bool ShowShadow { get; set; } = true;
 
     /// <summary>
     /// <para lang="zh">获得/设置 弹出前回调方法 默认 null</para>
-    /// <para lang="en">Gets or sets the callback before showing the context menu. Default is null.</para>
+    /// <para lang="en">Defines the callback that is executed before showing the context menu. Default is <see langword="null" />.</para>
     /// </summary>
     [Parameter]
     public Func<object?, Task>? OnBeforeShowCallback { get; set; }
 
     /// <summary>
     /// <para lang="zh">获得/设置 子组件</para>
-    /// <para lang="en">Gets or sets the child content.</para>
+    /// <para lang="en">The <see cref="RenderFragment"/> that represents the child content.</para>
     /// </summary>
     [Parameter]
     public RenderFragment? ChildContent { get; set; }
@@ -61,9 +61,7 @@ public partial class ContextMenu
 
     private object? _contextItem;
 
-    /// <summary>
     /// <inheritdoc/>
-    /// </summary>
     protected override void OnInitialized()
     {
         base.OnInitialized();
@@ -71,11 +69,7 @@ protected override void OnInitialized()
         ContextMenuZone.RegisterContextMenu(this);
     }
 
-    /// <summary>
     /// <inheritdoc/>
-    /// </summary>
-    /// <param name="firstRender"><para lang="zh">是否首次渲染</para><para lang="en">Whether this is the first render</para></param>
-    /// <returns><para lang="zh">异步任务</para><para lang="en">An asynchronous task</para></returns>
     protected override async Task OnAfterRenderAsync(bool firstRender)
     {
         await base.OnAfterRenderAsync(firstRender);
@@ -89,11 +83,20 @@ protected override async Task OnAfterRenderAsync(bool firstRender)
 
     /// <summary>
     /// <para lang="zh">弹出 ContextMenu</para>
-    /// <para lang="en">Show the ContextMenu</para>
+    /// <para lang="en">Shows the <see cref="ContextMenu"/>.</para>
     /// </summary>
-    /// <param name="args"><para lang="zh">鼠标事件参数</para><para lang="en">Mouse event arguments</para></param>
-    /// <param name="contextItem"><para lang="zh">上下文项</para><para lang="en">Context item</para></param>
-    /// <returns><para lang="zh">异步任务</para><para lang="en">An asynchronous task</para></returns>
+    /// <param name="args">
+    ///     <para lang="zh">鼠标事件参数</para>
+    ///     <para lang="en">The <see cref="MouseEventArgs"/> that invoked this event.</para>
+    /// </param>
+    /// <param name="contextItem">
+    ///     <para lang="zh">上下文项</para>
+    ///     <para lang="en">Context that is associated with the clicked <see cref="ContextMenuItem"/>.</para>
+    /// </param>
+    /// <returns>
+    ///     <para lang="zh">异步任务</para>
+    ///     <para lang="en">An asynchronous instance of a <see cref="Task"/>.</para>
+    /// </returns>
     internal async Task Show(MouseEventArgs args, object? contextItem)
     {
         _contextItem = contextItem;
@@ -115,15 +118,21 @@ private async Task OnClickItem(ContextMenuItem item)
 
     /// <summary>
     /// <para lang="zh">增加 ContextMenuItem 方法</para>
-    /// <para lang="en">Add a ContextMenuItem.</para>
+    /// <para lang="en">Adds an <paramref name="item"/> to the menu.</para>
     /// </summary>
-    /// <param name="item"><para lang="zh">要添加的项</para><para lang="en">The item to add</para></param>
+    /// <param name="item">
+    ///     <para lang="zh">要添加的项</para>
+    ///     <para lang="en">The <see cref="IContextMenuItem"/> to add</para>
+    /// </param>
     internal void AddItem(IContextMenuItem item) => _contextMenuItems.Add(item);
 
     /// <summary>
     /// <para lang="zh">移除 ContextMenuItem 方法</para>
-    /// <para lang="en">Remove a ContextMenuItem.</para>
+    /// <para lang="en">Removes an <paramref name="item"/> from the menu.</para>
     /// </summary>
-    /// <param name="item"><para lang="zh">要移除的项</para><para lang="en">The item to remove</para></param>
+    /// <param name="item">
+    ///     <para lang="zh">要移除的项</para>
+    ///     <para lang="en">The <see cref="IContextMenuItem"/> to remove</para>
+    /// </param>
     internal void RemoveItem(IContextMenuItem item) => _contextMenuItems.Remove(item);
 }
diff --git a/src/BootstrapBlazor/Components/ContextMenu/ContextMenuDivider.cs b/src/BootstrapBlazor/Components/ContextMenu/ContextMenuDivider.cs
index 2bb0887727f..a42e3701984 100644
--- a/src/BootstrapBlazor/Components/ContextMenu/ContextMenuDivider.cs
+++ b/src/BootstrapBlazor/Components/ContextMenu/ContextMenuDivider.cs
@@ -9,7 +9,7 @@ namespace BootstrapBlazor.Components;
 
 /// <summary>
 /// <para lang="zh">ContextMenuDivider 组件</para>
-/// <para lang="en">ContextMenuDivider component</para>
+/// <para lang="en">A component that defines a menu item as a divider in a context menu.</para>
 /// </summary>
 public class ContextMenuDivider : Divider, IContextMenuItem, IDisposable
 {
@@ -17,9 +17,7 @@ public class ContextMenuDivider : Divider, IContextMenuItem, IDisposable
     [NotNull]
     private ContextMenu? ContextMenu { get; set; }
 
-    /// <summary>
     /// <inheritdoc/>
-    /// </summary>
     protected override void OnInitialized()
     {
         base.OnInitialized();
@@ -27,10 +25,7 @@ protected override void OnInitialized()
         ContextMenu.AddItem(this);
     }
 
-    /// <summary>
     /// <inheritdoc/>
-    /// </summary>
-    /// <param name="builder"><para lang="zh">渲染树生成器</para><para lang="en">The render tree builder</para></param>
     protected override void BuildRenderTree(RenderTreeBuilder builder) { }
 
     private bool disposedValue;
@@ -39,7 +34,10 @@ protected override void BuildRenderTree(RenderTreeBuilder builder) { }
     /// <para lang="zh">释放资源方法</para>
     /// <para lang="en">Method to release resources.</para>
     /// </summary>
-    /// <param name="disposing"><para lang="zh">是否释放托管资源</para><para lang="en">Whether to release managed resources</para></param>
+    /// <param name="disposing">
+    ///     <para lang="zh">是否释放托管资源</para>
+    ///     <para lang="en">Flags whether to release managed resources</para>
+    /// </param>
     protected virtual void Dispose(bool disposing)
     {
         if (!disposedValue)
@@ -52,9 +50,7 @@ protected virtual void Dispose(bool disposing)
         }
     }
 
-    /// <summary>
     /// <inheritdoc/>
-    /// </summary>
     public void Dispose()
     {
         Dispose(disposing: true);
diff --git a/src/BootstrapBlazor/Components/ContextMenu/ContextMenuItem.cs b/src/BootstrapBlazor/Components/ContextMenu/ContextMenuItem.cs
index c07478c47eb..04fbe336089 100644
--- a/src/BootstrapBlazor/Components/ContextMenu/ContextMenuItem.cs
+++ b/src/BootstrapBlazor/Components/ContextMenu/ContextMenuItem.cs
@@ -7,7 +7,7 @@ namespace BootstrapBlazor.Components;
 
 /// <summary>
 /// <para lang="zh">ContextMenuItem 类</para>
-/// <para lang="en">ContextMenuItem class</para>
+/// <para lang="en">A type that represents a menu item in a <see cref="ContextMenu"/>.</para>
 /// </summary>
 public class ContextMenuItem : ComponentBase, IContextMenuItem, IDisposable
 {
@@ -20,28 +20,31 @@ public class ContextMenuItem : ComponentBase, IContextMenuItem, IDisposable
 
     /// <summary>
     /// <para lang="zh">获得/设置 图标</para>
-    /// <para lang="en">The icon to display.</para>
+    ///  <para lang="en">The CSS class name that represents an icon (if any)</para>
     /// </summary>
+    /// <example>
+    /// Icon="fa-solid fa-bookmark"
+    /// </example>
     [Parameter]
     public string? Icon { get; set; }
 
     /// <summary>
     /// <para lang="zh">获得/设置 是否被禁用 默认 false 优先级低于 <see cref="OnDisabledCallback"/></para>
-    /// <para lang="en">Gets or sets whether the item is disabled. Default is false. Lower priority than <see cref="OnDisabledCallback"/>.</para>
+    /// <para lang="en">Flags whether the item is disabled. Default is <see langword="false"/>. It has a lower priority than <see cref="OnDisabledCallback"/>.</para>
     /// </summary>
     [Parameter]
     public bool Disabled { get; set; }
 
     /// <summary>
     /// <para lang="zh">获得/设置 是否被禁用回调方法 默认 null 优先级高于 <see cref="Disabled"/></para>
-    /// <para lang="en">Gets or sets the callback to determine if the item is disabled. Default is null. Higher priority than <see cref="Disabled"/>.</para>
+    /// <para lang="en">Defines the callback to determine if the item is disabled. Default is <see langword="null" />. It has a higher priority than <see cref="Disabled"/>.</para>
     /// </summary>
     [Parameter]
     public Func<ContextMenuItem, object?, bool>? OnDisabledCallback { get; set; }
 
     /// <summary>
     /// <para lang="zh">获得/设置 点击回调方法 默认 null</para>
-    /// <para lang="en">Gets or sets the click callback. Default is null.</para>
+    /// <para lang="en">Defines the click callback. Default is <see langword="null" />.</para>
     /// </summary>
     [Parameter]
     public Func<ContextMenuItem, object?, Task>? OnClick { get; set; }
@@ -50,9 +53,7 @@ public class ContextMenuItem : ComponentBase, IContextMenuItem, IDisposable
     [NotNull]
     private ContextMenu? ContextMenu { get; set; }
 
-    /// <summary>
     /// <inheritdoc/>
-    /// </summary>
     protected override void OnInitialized()
     {
         base.OnInitialized();
@@ -79,9 +80,7 @@ protected virtual void Dispose(bool disposing)
         }
     }
 
-    /// <summary>
     /// <inheritdoc/>
-    /// </summary>
     public void Dispose()
     {
         Dispose(disposing: true);
diff --git a/src/BootstrapBlazor/Components/ContextMenu/ContextMenuTrigger.cs b/src/BootstrapBlazor/Components/ContextMenu/ContextMenuTrigger.cs
index 12c54488790..f378f5b6487 100644
--- a/src/BootstrapBlazor/Components/ContextMenu/ContextMenuTrigger.cs
+++ b/src/BootstrapBlazor/Components/ContextMenu/ContextMenuTrigger.cs
@@ -10,20 +10,17 @@ namespace BootstrapBlazor.Components;
 
 /// <summary>
 /// <para lang="zh">ContextMenuTrigger 组件</para>
-/// <para lang="en">ContextMenuTrigger component</para>
+/// <para lang="en">A component that defines a trigger that shows a <see cref="ContextMenu"/>.</para>
 /// </summary>
 public class ContextMenuTrigger : BootstrapComponentBase
 {
-    /// <summary>
-    /// <para lang="zh">获得/设置 子组件</para>
-    /// <para lang="en">Gets or sets the child content.</para>
-    /// </summary>
+    /// <inheritdoc cref="ContextMenu.ChildContent" />
     [Parameter]
     public RenderFragment? ChildContent { get; set; }
 
     /// <summary>
     /// <para lang="zh">获得/设置 包裹组件 TagName 默认为 div</para>
-    /// <para lang="en">Gets or sets the wrapper component tag name. Default is div.</para>
+    /// <para lang="en">The HTML tag name to use for the trigger. Default is &lt;div&gt;.</para>
     /// </summary>
     [Parameter]
     public string WrapperTag { get; set; } = "div";
@@ -53,9 +50,7 @@ public class ContextMenuTrigger : BootstrapComponentBase
         .AddClassFromAttributes(AdditionalAttributes)
         .Build();
 
-    /// <summary>
     /// <inheritdoc/>
-    /// </summary>
     protected override void OnParametersSet()
     {
         base.OnParametersSet();
@@ -63,10 +58,7 @@ protected override void OnParametersSet()
         OnTouchDelay ??= Options.CurrentValue.ContextMenuOptions.OnTouchDelay;
     }
 
-    /// <summary>
     /// <inheritdoc/>
-    /// </summary>
-    /// <param name="builder"><para lang="zh">渲染树生成器</para><para lang="en">The render tree builder</para></param>
     protected override void BuildRenderTree(RenderTreeBuilder builder)
     {
         builder.OpenElement(0, WrapperTag);
@@ -82,14 +74,14 @@ protected override void BuildRenderTree(RenderTreeBuilder builder)
 
     /// <summary>
     /// <para lang="zh">点击 ContextMenu 菜单项时触发</para>
-    /// <para lang="en">Triggered when a ContextMenu menu item is clicked.</para>
+    /// <para lang="en">Triggered when a context menu item is clicked.</para>
     /// </summary>
     [DynamicDependency(DynamicallyAccessedMemberTypes.PublicMethods, typeof(MouseEventArgs))]
     public Task OnContextMenu(MouseEventArgs args) => ContextMenuZone.OnContextMenu(args, ContextItem);
 
     /// <summary>
     /// <para lang="zh">是否触摸</para>
-    /// <para lang="en">Indicates whether touch has started.</para>
+    /// <para lang="en">Indicates whether a touch event is started.</para>
     /// </summary>
     public bool IsTouchStarted { get; private set; }
 
diff --git a/src/BootstrapBlazor/Components/ContextMenu/ContextMenuZone.razor.cs b/src/BootstrapBlazor/Components/ContextMenu/ContextMenuZone.razor.cs
index bd8cbff4c3a..e61c5be0eb5 100644
--- a/src/BootstrapBlazor/Components/ContextMenu/ContextMenuZone.razor.cs
+++ b/src/BootstrapBlazor/Components/ContextMenu/ContextMenuZone.razor.cs
@@ -9,14 +9,11 @@ namespace BootstrapBlazor.Components;
 
 /// <summary>
 /// <para lang="zh">ContextMenuZone 组件</para>
-/// <para lang="en">ContextMenuZone component</para>
+/// <para lang="en">The ContextMenuZone defines the area in the DOM where the context menu can be displayed.</para>
 /// </summary>
 public partial class ContextMenuZone
 {
-    /// <summary>
-    /// <para lang="zh">获得/设置 子组件</para>
-    /// <para lang="en">Gets or sets the child content.</para>
-    /// </summary>
+    /// <inheritdoc cref="ContextMenu.ChildContent" />
     [Parameter]
     public RenderFragment? ChildContent { get; set; }
 
@@ -44,8 +41,11 @@ internal async Task OnContextMenu(MouseEventArgs args, object? contextItem)
 
     /// <summary>
     /// <para lang="zh">ContextMenu 组件调用</para>
-    /// <para lang="en">Called by the ContextMenu component</para>
+    /// <para lang="en">Registers a <paramref name="contextMenu"/> with this zone.</para>
     /// </summary>
-    /// <param name="contextMenu"><para lang="zh">要注册的 ContextMenu 组件</para><para lang="en">The ContextMenu component to register</para></param>
+    /// <param name="contextMenu">
+    ///     <para lang="zh">要注册的 ContextMenu 组件</para>
+    ///     <para lang="en">The <see cref="ContextMenu"/> to register</para>
+    /// </param>
     internal void RegisterContextMenu(ContextMenu contextMenu) => _contextMenu = contextMenu;
 }

From a9687f54e8e1fe5638ae77f7b18013efb696708c Mon Sep 17 00:00:00 2001
From: peereflits <peereflits@live.com>
Date: Fri, 16 Jan 2026 12:59:19 +0100
Subject: [PATCH 3/3] docs: wrapped example in code block

---
 src/BootstrapBlazor/Components/ContextMenu/ContextMenuItem.cs | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/src/BootstrapBlazor/Components/ContextMenu/ContextMenuItem.cs b/src/BootstrapBlazor/Components/ContextMenu/ContextMenuItem.cs
index 04fbe336089..30e22411ccc 100644
--- a/src/BootstrapBlazor/Components/ContextMenu/ContextMenuItem.cs
+++ b/src/BootstrapBlazor/Components/ContextMenu/ContextMenuItem.cs
@@ -23,7 +23,9 @@ public class ContextMenuItem : ComponentBase, IContextMenuItem, IDisposable
     ///  <para lang="en">The CSS class name that represents an icon (if any)</para>
     /// </summary>
     /// <example>
+    /// <code>
     /// Icon="fa-solid fa-bookmark"
+    /// </code> 
     /// </example>
     [Parameter]
     public string? Icon { get; set; }