What would you consider "too many comments" for a library?

70 points wowisthatreal

I'm currently working on a small crate that reads data from a binary file and parses it into rust structures. The file format itself is quite undocumented and I had to figure a lot of stuff out myself- which is why I started commenting all my struct members and public functions for future reference.

I personally prefer writing minimal comments and trying to make my code readable and understandable (exception being when I do something stupid and have to explain it in my comments), so I'm unsure of what I should do.

Given that this is a library that I imagine will be used by someone other than me in the future, do you think that this is normal or excessive?

Here's an example struct from my code:

https://preview.redd.it/ig8wy3l20okd1.png?width=1814&format=png&auto=webp&s=eeadafdc6771293acfbc45b87a2ca50ec9e42853