add some documentation for the Thorium actor machine.

Signed-off-by: Sébastien Boisvert <boisvert@anl.gov>