Common Mistakes
1. Using notes for customer-visible discussion
Section titled “1. Using notes for customer-visible discussion”Use Pragmatic.Comments for public or customer-facing conversation. Notes are meant for internal annotations.
2. Missing [Entity<TId>]
Section titled “2. Missing [Entity<TId>]”The generator needs the parent id type to create the child note entity correctly.
3. Missing partial
Section titled “3. Missing partial”The trait adds generated members to the parent entity, so the parent class must be partial.
4. Expecting anonymous authors
Section titled “4. Expecting anonymous authors”Notes are internal and always require an author identity.
5. Forgetting the edit window
Section titled “5. Forgetting the edit window”If EditWindowMinutes is set, updates can be rejected after the configured period.