clean up, taking a first stab at documentation