yeah we could probably flesh out the docs a bit more (or if you want to make an open source contribution, feel free to raise a PR 😄 )