- we should enhance the documentation here so we aren't
  operating in the dark as to the basic process flow.