---
-Starlette is a small library for working with ASGI.
+Starlette is a small library for working with [ASGI](https://asgi.readthedocs.io/en/latest/).
It gives you `Request` and `Response` classes, a test client, and a
decorator for writing super-minimal applications.
Starlette will automatically include a content-length header. It will also
set the content-type header, including a charset for text types.
+Once you've instantiated a response, you can send it by calling it as an
+ASGI application instance.
+
```python
class App:
def __init__(self, scope):