Cleaning up the Organizer spec

I cleaned up the spec to provide better documentation. No functional change is in this commit.