revise initial documentation