update doc for show/hide (which would benefit from more updates)