Update docs

E.g. add alert state flow diagram:


```mermaid
stateDiagram
    direction LR
    [*]-->Open: created
    Open --> Open: appeared_in_branch
    Open-->Dismissed: closed_by_user
    Open-->Fixed: fixed
    Dismissed-->Open: reopened_by_user
    Fixed-->Open: reopened
```