add an custom mode example in the docs
add confirm label and a small refacto