add docs to explain changes to `closest`