As others have said, there's a difference between api documenting comments and in-line comments. From my perspective, the main difference is that an in-line comment is read alongside the code, whereas a documentation comment is read alongside the signature of whatever you're commenting. Given this, we can apply the same DRY principle. Is the comment saying the same thing as the signature? Let's look at your example: This part just repeats what we already see from the name .
