From a98d5807da2d5c568075c1bd72bc92c1c17c934c Mon Sep 17 00:00:00 2001 From: Patrik Nordwall Date: Fri, 4 Oct 2019 11:51:59 +0200 Subject: [PATCH] Add Intro section to actor-lifecycle.md --- akka-docs/src/main/paradox/typed/actor-lifecycle.md | 13 ++++++++++++- 1 file changed, 12 insertions(+), 1 deletion(-) diff --git a/akka-docs/src/main/paradox/typed/actor-lifecycle.md b/akka-docs/src/main/paradox/typed/actor-lifecycle.md index d077aa5f90..a90fe4420b 100644 --- a/akka-docs/src/main/paradox/typed/actor-lifecycle.md +++ b/akka-docs/src/main/paradox/typed/actor-lifecycle.md @@ -19,7 +19,18 @@ To use Akka Actor Typed, you must add the following dependency in your project: ## Introduction -TODO intro +An actor is a stateful resource that has to be explicitly started and stopped. + +It is important to note that actors do not stop automatically when no longer +referenced, every Actor that is created must also explicitly be destroyed. +The only simplification is that stopping a parent Actor will also recursively +stop all the child Actors that this parent has created. All actors are also +stopped automatically when the `ActorSystem` is shut down. + +@@@ note +An `ActorSystem` is a heavyweight structure that will allocate threads, +so create one per logical application. Typically on `ActorSystem` per JVM process. +@@@ ## Creating Actors