I can't tell you what is better, but that my approach works very good for me: Users of my code never read the implementation. They want to know how to use my methods. That's header only. And editors / IDEs can display the comments as little popup windows while writing codeOriginally Posted by zlatko
A maintainer probably already knows how to use the method and jumps directly to the implementation to fix it which should be easier with the comments there which describe what you did.
Bookmarks