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.