Troubleshooting

Whenever you run into problems with Ampersand, and you cannot find what you are looking for in this documentation, have a look at the common problems below. When your problem isn't there, see if you can find an issue for it. Otherwise, do one of:

1. If your problem is with this documentation (you miss some explanation), or just file an issue that is specific for this documentation .
2. If your problem is with the ampersand method or tooling, you can file an issue that is specific for Ampersand itself.

Common Problems

1. Maximum reruns exceeded while running a prototype. The ExecEngine is caught in an oscillation: your invariants are, given the data, jointly unsatisfiable, so the automatic repair never reaches a fixpoint. Do not raise the rerun limit — that hides the contradiction. The worked case Diagnosing oscillations shows how to trace it back to the colliding rules and fix it properly.
2. The documentation is far from complete. We are working on it though. If you are stuck, please create an issue! You are more than welcome!