You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
I propose updating the C# language specification to define a <note> block-level element in the context of XML documentation comments. The <note> element has a type attribute, which is allowed to be any identifier but the following note types are predefined:
note: A general note. This is the default if the type attribute is omitted.
I like it. In the absence of any stricter enforcement, it would be useful to tell a child class whether a method override should call the base or not without any callers caring about that aspect when they read the comment.
Should override be separate from inherit? I can't see any ambiguity, but it seems like it might be appropriate.
I propose updating the C# language specification to define a
<note>
block-level element in the context of XML documentation comments. The<note>
element has atype
attribute, which is allowed to be any identifier but the following note types are predefined:note
: A general note. This is the default if thetype
attribute is omitted.implement
: Note to implementerscaller
: Note to callersinherit
: Note to inheritorsimportant
: An important notesecurity
: A security note🔗 note (Sandcastle XML Comments Guide)
The text was updated successfully, but these errors were encountered: