make appropriate updates to docs