design & docs update