Summary of the new feature / enhancement

we should review all the triple-slash comments in our code base:
[ ] Order of tags should be consistent
[ ] Documentation should accurately describe the code

Proposed technical implementation details (optional)

No response