Improve documentation

README.md

@@ -7,7 +7,9 @@ JSON-RPC 2.0 library (server and client) with HTTP and WebSockets support for
 
 ### respond
 
-Takes `Methods`, `ServerRequest` and `Options`.
+Takes `Methods`, `ServerRequest` and `Options`. Look
+[here](https://github.com/timonson/gentle_rpc/blob/master/server/response.ts)
+for more information about `Options`.
 
 ```typescript
 import { listenAndServe } from "https://deno.land/[email protected]/http/server.ts";
@@ -141,13 +143,10 @@ let noise2 = await remote.batch({
 
 ### WebSockets
 
-The support for WebSockets is still experimental and has not been fully tested
-yet.
-
 #### call
 
 Takes a string and an `Array<JsonValue>` or `Record<string, JsonValue>` object
-and returns `Promise<JsonValue | undefined>`.
+and returns `Promise<JsonValue>`.
 
 ```typescript
 const noise = await remote.call("callNamedParameters", {
@@ -160,6 +159,8 @@ const noise = await remote.call("callNamedParameters", {
 remote.socket.close();
 ```
 
+Notifications return `Promise<undefined>`.
+
 ##### notification
 
 ```typescript

server/response.ts

@@ -15,7 +15,7 @@ export type Options = {
   publicErrorStack?: boolean;
   // enable 'subscribe', 'emit' and 'unsubscribe' (only ws):
   enableInternalMethods?: boolean;
-  // defaults to both:
+  // defaults to 'both':
   proto?: "ws" | "http" | "both";
   // Enable CORS via the "Access-Control-Allow-Origin" header (only http):
   cors?: boolean;