docs: restructure into topical sections and add the four most-asked-for pages (#3044)
This commit is contained in:
parent
080f2a869d
commit
220d362112
1 changed files with 2403 additions and 343 deletions
|
|
@ -84,7 +84,7 @@ In increasing order of how much you should hesitate:
|
|||
The SDK ships exactly one middleware, and it is already on your server's list: the one that
|
||||
emits an OpenTelemetry span for every message. You don't append it, and most of the time you
|
||||
don't think about it. It is a no-op until you install an exporter, and it has its own page:
|
||||
**[OpenTelemetry](opentelemetry.md)**.
|
||||
**[OpenTelemetry](../run/opentelemetry.md)**.
|
||||
|
||||
!!! info
|
||||
If you have written ASGI middleware, you already know this shape. Starlette's
|
||||
|
|
@ -101,8 +101,8 @@ don't think about it. It is a no-op until you install an exporter, and it has it
|
|||
* `ctx.request_id is None` is how you tell a notification from a request.
|
||||
* Raise instead of calling `call_next` to refuse one message; the connection survives.
|
||||
* The SDK's own OpenTelemetry tracing is a middleware too, already on the list. See
|
||||
**[OpenTelemetry](opentelemetry.md)**.
|
||||
**[OpenTelemetry](../run/opentelemetry.md)**.
|
||||
* The whole surface is provisional. Observe with it; don't build on it.
|
||||
|
||||
That is everything that wraps a request. **[Authorization](authorization.md)** is what decides whether the request
|
||||
That is everything that wraps a request. **[Authorization](../run/authorization.md)** is what decides whether the request
|
||||
gets to run at all.
|
||||
|
|
|
|||
Loading…
Reference in a new issue