You are right, this needs more docs. I will add more details on the documentation page.