add that documentation you just wrote to the code. also you can create 'default' values for `force` and `change_hash` by doing `force = force || true;` so you don't have to explicitly specify the same values all over the codebase