Troubleshooting

If you're having problems contributing, we want to help:

  • ask for help in #contributors in Slack. Or DM Paul Biggar directly if you prefer.
  • make an issue describing the problem, and someone will come help.

Common fixes:

  • Sometimes there are compilation problems where the build caches from various package managers we use (npm, esy, opam, cargo) develop problems. They can be fixed by clearing the build directories (which are in Docker volumes) by running the related scripts:
    • for client errors, use ./scripts/clear-bs-cache and ./scripts/clear-node-modules
    • for other errors, use ./scripts/clear-builder-volumes
  • Integration tests sometimes fail. At time of writing execute_function_works is the only flaky integration test, and you can ignore related test failures.