This commit clarifies and corrects documentation in several public header files. The changes include fixing typos, improving wording, and adding missing details to make the API easier to understand and use. No functional changes are included in this commit.