chore: more comprehensive docs