Finalize the actor documentation.

- Document the main design decision
- Detail key design aspects
- Remove things that have been implemented differently
- Remove the example from the appendix

Signed-off-by: Didier Wenzek <didier.wenzek@free.fr>