docs: provide some better documentation