Anthony Trad
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 !

Anthony Trad
Anthony Trad

Written by Anthony Trad

Senior Software Engineer focused on .NET and the Cloud. Reconsidering major principles and patterns, ideas are my own.

Responses (1)