BS-10273 : As Dave, I need to know about the Actor API

- Update javadoc