Improves documentation for zactor class

Adds remark about expected behavior of actor function.
Merge pull request #581 from ahhentz/documentation

Improves documentation for zactor class