Almost nobody uses it correctly, every time somebody tries to use it @isaacs tells them they shouldn't be using it, and its semantics are somewhere between undefined and actively dangerous under unusual circumstances. Better documentation on how to explicitly recover from errors in domains would be a better substitute.