diff --git a/FruitBank.Common/FruitBank.Common.csproj b/FruitBank.Common/FruitBank.Common.csproj
index e9d8d297..3bf06d58 100644
--- a/FruitBank.Common/FruitBank.Common.csproj
+++ b/FruitBank.Common/FruitBank.Common.csproj
@@ -5,7 +5,7 @@
     <ImplicitUsings>enable</ImplicitUsings>
 	<Nullable>enable</Nullable>
 	  <CopyLocalLockFileAssemblies>true</CopyLocalLockFileAssemblies>
-	<EmitCompilerGeneratedFiles>false</EmitCompilerGeneratedFiles>
+	<EmitCompilerGeneratedFiles>true</EmitCompilerGeneratedFiles>
   </PropertyGroup>
 
   <ItemGroup>
diff --git a/docs/CONVENTIONS.md b/docs/CONVENTIONS.md
index a7fae458..2da38102 100644
--- a/docs/CONVENTIONS.md
+++ b/docs/CONVENTIONS.md
@@ -14,6 +14,10 @@
 - **OnGrid prefix** for MgGridBase event parameters: `OnGridItemDeleting`, `OnGridEditModelSaving`, `OnGridFocusedRowChanged`, etc. (avoids collision with DxGrid base events).
 - **SignalRTags** constants use numeric ranges by domain (see `FruitBank.Common/SignalRs/`).
 
+## XML Documentation
+
+`<summary>` — 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 `<example>` only when usage is non-obvious; otherwise omit.
+
 ## Patterns
 
 - **MeasuringItemPalletBase** as abstract base for all three measurement hierarchies.