docs: clearer shell commands, added example output