The current documentation of bats does not lend itself to an easy introduction. There are several resources out there that give an introduction (e.g. https://advancedweb.hu/testing-bash-scripts-with-the-bats-testing-framework/, https://medium.com/@pimterry/testing-your-shell-scripts-with-bats-abfca9bdc5b9, https://opensource.com/article/19/2/testing-bash-bats) but they are not official in the sense that they are not hosted here and some of them are quite aged, so they don't reflect the current state of bats anymore.

I think it would be worthwhile to have a short tutorial that introduces the fundamentals of bats and maybe a list of common mistakes and pitfalls that will get especially beginners confused.

To that end, I would propose we gather ideas and common mistakes here.