junior developer here.
I am currently working alone on a web appsapplication for a big client of my company.
The I started last month. The client wants >at least 25% of comments in each of its software projects.
I checked the code of prev. apps.previous applications and here are my obs.observations :
- each file begin with a comment block (package, date last updated, name of my company & copyright)
- all variables are commented with their names
// nameOfCustomer public String nameOfCustomer - all gets'n'setsgetters and setters are commented
- vvery few useful comments
It seems like devsdevelopers just place as much comments as they can to hit that 25% threshold, regardless of quality and usefulness. My company tells me that "we do it as the client wants it".
I did not speak directly with the client about this. Here are my arguments so far :
- useless lines to read and to write (waste of time)
- comments are sometimes not updated (source of confusion)
- developers are less likely to use or trust real useful comments
What is your adv.advice on this subsubject ? How should I handle the sitsituation ?