Improve XML comments for public methods

[Timmoth]

It'll be helpful to communicate usage / intent to end users

See here for more details:
https://learn.microsoft.com/en-us/dotnet/csharp/language-reference/xmldoc/recommended-tags

Including:

• parameters
• description
• exceptions