:book: update docs with options