revise documentation