update docs example commands and how they work