document current state of code