less doc is more at this point

need to think more about testability