clarify comments and reorder.

Primary change is to place the "actions" in their own comment group after the methods that set the "Target".  It makes little sense to consider actions (plans and executions) until the target state has been set.
Merge pull request #240 from acornacorn/groovy-devel

clarify comments and reorder.