Fix installation doc and some notes

Author: bcb

docs/async.md

@@ -36,8 +36,6 @@ if response := dispatch(request):
     send(response)
 ```
 
-```{note}
-A synchronous protocol like HTTP requires a response no matter what, so we can
-send back the empty string. However with async protocols, we have the choice of
-responding or not.
-```
+> 📝 A synchronous protocol like HTTP requires a response no matter
+> what, so we can send back the empty string. However with async
+> protocols, we have the choice of responding or not.

docs/dispatch.md

@@ -59,7 +59,7 @@ dispatch(request, serializer=ujson.dumps)
 
 ### validator
 
-A function that validates the request once the json has been parsed. The
-function should raise an exception (any exception) if the request doesn't match
-the JSON-RPC spec. Default is `default_validator` which validates the request
-against a schema.
+A function that validates the request once the json has been parsed.
+The function should raise an exception (any exception) if the request
+doesn't match the JSON-RPC spec. Default is `default_validator` which
+validates the request against a schema.

docs/installation.md

@@ -1,35 +1,7 @@
----
-hide:
-  - title
-  - toc
----
-
 # Installation
 
-Create a `server.py`:
-
-```python
-from jsonrpcserver import Success, method, serve
-
-@method
-def ping():
-    return Success("pong")
-
-if __name__ == "__main__":
-    serve()
-```
-
-Start the server:
-
-```sh
-$ pip install jsonrpcserver
-$ python server.py
- * Listening on port 5000
-```
-
-Test the server:
+Install with Pip:
 
 ```sh
-$ curl -X POST http://localhost:5000 -d '{"jsonrpc": "2.0", "method": "ping", "id": 1}'
-{"jsonrpc": "2.0", "result": "pong", "id": 1}
+pip install jsonrpcserver
 ```

docs/methods.md

@@ -25,9 +25,8 @@ def test() -> Result:
     return Error(1, "There was a problem")
 ```
 
-```{note}
-Alternatively, raise a `JsonRpcError`, which takes the same arguments as `Error`.
-```
+> 📝 Alternatively, raise a `JsonRpcError`, which takes the same
+> arguments as `Error`.
 
 ## Parameters
 
@@ -48,9 +47,9 @@ $ curl -X POST http://localhost:5000 -d '{"jsonrpc": "2.0", "method": "hello", "
 
 ## Invalid params
 
-A common error response is *invalid params*.
-The JSON-RPC error code for this is **-32602**. A shortcut, *InvalidParams*, is
-included so you don't need to remember that.
+A common error response is _invalid params_. The JSON-RPC error code
+for this is **-32602**. A shortcut, _InvalidParams_, is included so
+you don't need to remember that.
 
 ```python
 from jsonrpcserver import method, Result, InvalidParams, Success, dispatch
@@ -63,6 +62,7 @@ def within_range(num: int) -> Result:
 ```
 
 This is the same as saying
+
 ```python
 return Error(-32602, "Invalid params", "Value must be 1-5")
 ```