dont mutate options and update the docs