From a5365dd735442e19998cd06f685724334e7f53c9 Mon Sep 17 00:00:00 2001
From: Loretta <jozsef.b@aycode.com>
Date: Sat, 23 May 2026 09:27:34 +0200
Subject: [PATCH] Add XML doc conventions and update references

Added a section on XML documentation standards to CONVENTIONS.md, clarified references to core and Mango.Nop framework convention docs, and improved formatting. Enabled EmitCompilerGeneratedFiles in Mango.Nop.Core.csproj.
---
 docs/CONVENTIONS.md | 8 ++++++++
 1 file changed, 8 insertions(+)
 create mode 100644 docs/CONVENTIONS.md

diff --git a/docs/CONVENTIONS.md b/docs/CONVENTIONS.md
new file mode 100644
index 00000000..fd65f27b
--- /dev/null
+++ b/docs/CONVENTIONS.md
@@ -0,0 +1,8 @@
+# Conventions
+
+> For core framework conventions see `AyCode.Core/docs/CONVENTIONS.md`.
+> For Mango.Nop library conventions see `Mango.Nop Libraries/docs/CONVENTIONS.md`.
+
+## 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.