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.
This commit is contained in:
Loretta 2026-05-23 09:27:34 +02:00
parent e9fc609523
commit a5365dd735
1 changed files with 8 additions and 0 deletions

8
docs/CONVENTIONS.md Normal file
View File

@ -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.