// 8 attempts have been made to clean up this code. // A total of 47 hours have been wasted here. // Update the counters after your attempt.// TODO: Leave the code cleaner than you found
ToDo’s belong in tickets, not in the code.
Todo with ticket number
As long as “cleaner than you found it” also includes “better documented.” I’ve worked with people who think that “the code should speak for itself” to the point that they will make biased decisions with no explanation or documentation and then if you ask them about it after their response is “look at the PR for how that decision was made.” I’m not going to git blame and find your PR to find an outcome from an argument between two people that after scrolling just says “sometimes the API returns a JSON string here instead of nested JSON so we have this conditional” when that could be a comment
Not to mention that sometimes, the code that’s supposed to “speak for itself” doesn’t do the things that they think it would do.
Right. Given the option I will always choose to work with a decent programmer who can communicate well and documents their code, over a very strong programmer that doesn’t think they should waste time with documentation
Hi it’s me, your colleague
Hi colleague! So I found a comment in the code from 3 years ago by you saying you should “improve this”. Is it planned for the next sprint?
I’ll get right on that, as soon as I wrap up these 3 defects
Just remember to mark all the things you’d like to make better but can’t be arsed to at the moment with numerous TODOs.
