update doc blocs