C#: Move signal documentation to the event

[raulsntos]

Move signal documentation from the delegate to the event and also deprecate the event if the signal is deprecated.

Alternatively, we may want to keep the documentation in the delegate too.

[neikeq]

Alternatively, we may want to keep the documentation in the delegate too.

I suppose the delegate could specify which signal it's for, but I'm not sure what the convention is there.

[raulsntos]

I'm not sure what the convention is either but it seems Microsoft usually documents these delegates as:

Represents the method that handles the {EventName} event of a {ClassName} class.

[neikeq]

I'm not sure what the convention is either but it seems Microsoft usually documents these delegates as:

Represents the method that handles the {EventName} event of a {ClassName} class.

Where did you find this? All the events I find use the EventHandler delegate.

[raulsntos]

I just randomly searched delegates that end with the EventHandler suffix in the BCL (using https://apisof.net/). A few examples:

• TransactionCompletedEventHandler
• XmlNodeChangedEventHandler
• PrintEventHandler

[neikeq]

Ah, I see. That's the convention I would follow then.