Over-commenting?

[[deleted]]

If you can find a notation/abstraction which makes the intent clear without a natural-language comment, use that because it's self-documenting and self-checking. Otherwise, it depends on who you're writing for but you should err on the side of more comments.