Aug 18, 2022
That's true, but even if you explain why you're doing it. This is yet another piece to maintain, your code changes, evolves and matures with time and keeping track and updating the comments as you go is nearly impossible.
Also, how many time did you change in your application flow, or didn't understand an old comment with some turnovers.
If you should explain some business proccess, put it in the technical documentation as it is centralized and maintained by all the team.
Hope this makes it clearer !