documented some of the remaining todos for next update