Align docs with new behavior
Add some examples