document updates and clean up.