- A lot of functions were async and returned `Task` without awaiting anything - Some functions had a void Task as return type but actually returned a value
fixes #9405 add some API design docs. I decided some of the things in #9405 (HubMethodName, Typed clients, etc.) fit better in the Hub API doc so I'll submit a separate PR for those soon I'm sure I messed up the code snippets somehow :). Will have to wait and see how the review copy turns out. [Internal Review Link](https://review.docs.microsoft.com/en-us/aspnet/core/signalr/api-design?view=aspnetcore-2.1&branch=pr-en-us-9455)