docs(all): improve docs