diff --git a/Mango.Nop.Core/Mango.Nop.Core.csproj b/Mango.Nop.Core/Mango.Nop.Core.csproj
index d4e6715..f4a2b1f 100644
--- a/Mango.Nop.Core/Mango.Nop.Core.csproj
+++ b/Mango.Nop.Core/Mango.Nop.Core.csproj
@@ -6,6 +6,7 @@
enable
bin\FruitBank
False
+ true
true
true
diff --git a/Mango.Nop.Core/docs/CONVENTIONS.md b/Mango.Nop.Core/docs/CONVENTIONS.md
index 39ab8f8..886c5e0 100644
--- a/Mango.Nop.Core/docs/CONVENTIONS.md
+++ b/Mango.Nop.Core/docs/CONVENTIONS.md
@@ -18,6 +18,10 @@ Follow the doctrine in AyCode.Core's `docs/CONVENTIONS.md#framework-first-placem
- **`IMg` prefix**: for Mango-framework-level interfaces (e.g. `IMgModelDtoBase`, `IMgSoftRemoveEntity`)
- **No prefix**: for NopCommerce entity mirrors in `NopDependencies/` — they stay in Nop namespace, same name as upstream
+## XML Documentation
+
+`` — brief, developer-facing, readable in VS IntelliSense tooltip. NO implementation details, NO wire-format / byte-level / perf specifics — those live in `docs/TOPIC/*.md`. Add `` only when usage is non-obvious; otherwise omit.
+
## See Also
- Core framework naming (`Ac` / `IAc` prefixes), patterns, serialization conventions: AyCode.Core's `docs/CONVENTIONS.md`
diff --git a/docs/CONVENTIONS.md b/docs/CONVENTIONS.md
index 5b6b8fb..9b60b17 100644
--- a/docs/CONVENTIONS.md
+++ b/docs/CONVENTIONS.md
@@ -9,6 +9,10 @@
- **`Base` suffix** for abstract base classes: `MgEntityBase`, `ModelDtoBase`, `MgBackgroundServiceBase`.
- **`Nop` prefix** for nopCommerce bridge types: `NopLogWriter`, `NopLoggerMsSqlNopDataProvider`, `NopCommonConst`.
+## XML Documentation
+
+`` — brief, developer-facing, readable in VS IntelliSense tooltip. NO implementation details, NO wire-format / byte-level / perf specifics — those live in `docs/TOPIC/*.md`. Add `` only when usage is non-obvious; otherwise omit.
+
## Patterns
### DTO Bidirectional Mapping