Absolutely agree: this is critical (I do the same myself in the documentation for my TS/pg library, https://jawj.github.io/zapatos/).