Opening up the Angular documentation to have a look, it appears that every page has an "improve this doc" button, which allows you to submit a pull request to g

Opening up the Angular documentation to have a look, it appears that every page has an "improve this doc" button, which allows you to submit a pull request to get the official documentation changed. Surely if you find that the documentation is unclear, it's better to add a note or a clarification directly into the documentation than write a comment?