squash: move API heuristics to end of doc
squash: drop atomicity doc