Create documentation

Revert "Revert "Fix mac ci build""

Revert "Fix mac ci build"

Fix mac ci build

While at it, update the sh script too.

Use IEnumerable<dynamic> instead of dynamic for collections

Updated deployment documentation

Because of the using blocks, these one line methods need the async
modifier so that the that async state machiner is created. Otherwise, if
the method does not complete synchronously, the connection is closed
before the database has returned its results.

The methods that return collections should return
Task<IEnumerable<dynamic>> not Task<dynamic>

Instead to register EventHandlers we register Func<EventHandlers> which solves scope problems (having transient/scoped objects owned by singletons)