"An ounce of prevention is worth a pound of cure" goes the saying. Having a strict coding standard is prevention. To create good code you must have good standards, such as commenting standards, naming standards, versioning standards and knowing the value of consistency.
But this can really only happen if you’re going to go the extra mile and stick your neck out and correct someone.
❌ Figure: Bad example - Receiving corrections is never easy and often received more harshly than the giver intended
✅ Figure: Good example - Go super gentle when people make mistakes. Correct them as though they’re a soft cute puppy 🐶
Every member of a team plays an important role in maintaining standards. Whether it's your work or someone else's, always keep an eye out for things that can be improved.
This rule applies to all company standards. Standards are important because they ensure your experience at work is consistent and enjoyable. For example, if there was no standard to stack the dishes in the dishwasher when you were finished using them, dishes would build up and create a big mess in the kitchen!
When you receive a great 'Done' email or document, make sure you mention how great it is before correcting any potential error.
Learn more about correcting someone in a nice way.
When the 'mistake' the person made is not an actual mistake, but something that the company has decided to do in one way for consistency, without a strong argument.
Tiny Tip: I’d use international format on your phone number so people outside Australia can just click to dial as per ssw.com.au/rules/right-format-to-show-phone-numbers
✅ Figure: Good example - Nicely informing of a small standard oversight
When there is a proven better way to do something different from what the person has done. You should try to include the reasons.
Tip: I noticed your email has a very generic subject: "website". Please resend with a descriptive email subject as per Rules to Better Email. This way it is easier to identify, categorize and find this email later, without having to open it :)
✅ Figure: Good example - Nicely informing of a better way to do something
When the error the person committed can lead to a misunderstanding or a security breach. You should include a task with action when necessary.
Critical: When sending a proposal never use the word "quote", but use "estimate" instead. As per Rules to Better Project Management we don't work with a fixed price, which is opposite to what the word "quote" implies. This might create different expectation and consequently frustration and legal problems with the client.
✅ Figure: Good example - Nicely informing of a critical mistake
When you come across a code error, it's always better if you just fix it straight away. Then write an email to the person explaining what has been done wrong and how you fixed it.
In cases where you aren't able to fix yourself, send an email to report the error/bug, which should be become a PBI and then fixed.
You will be surprised at how many developers write bad PBIs. You need to be a standards watchdog and correct them until they understand the importance. Be patient, it takes many times, they do eventually write good quality PBIs.
Tips:
When you notice someone doing the wrong thing:
It can be tempting to offer your feedback as soon as you think of it, but it's better to hold off until the recipient is in a place where they can hear it. If a person is busy, distracted, or in a poor emotional state, chances are your feedback won’t hit the mark.
Wait until the person is calm and relaxed before asking them if now is a good time to offer your feedback.
For more, check out Do you know to create a safe space instead of jumping into feedback?
❌ Figure: Bad example - Seeing a mistake and not pointing it out doesn't improve a person. Allow them to benefit from your experience!
If a critique is personal, it can be hard to correct someone – especially if you don’t have a close relationship with that person. In a case like this, you should discretely ask your manager how to proceed.
Using ChatGPT can be an effective way to correct someone nicely. It allows you to provide feedback in a friendly and creative manner, reducing the risk of making the recipient feel defensive or upset. Use ChatGPT to create a personalized and entertaining message that communicates your feedback.
Example prompt:
"Act as a rules watchdog and ask Bob to:
Number each point. Make it friendly and funny by acting as a dog character. Be concise.”
✅ Figure: The example prompt generates a fun email
Providing feedback in a light-hearted and friendly manner can encourage colleagues to be more receptive to suggestions. Click “Regenerate response” if you don't like the output!
Say 'thank you' to a person's corrections to show you don't have thin skin and encourage further positive and negative feedback
✅ Figure: Good example - Be thankful... it all helps you to improve
It's important to ensure others are doing their best to maintain and follow the standards. Remember, it can be just as important for someone's professional development to give feedback as it is to receive it. Being able to communicate feedback in an effective and professional manner can benefit you in any career.
While you were away, I came across this page you edited, called ApplicationForm.aspx which was giving an error:
> The conversion of a char data type to a DateTime data type resulted in an out-of-range DateTime value.
Please note that whilst inserting data from your Front End application, you should not use the format dd/mm/yyyy. Instead, you should use yyyy/mm/dd as per Rules to Better Databases.
Let's fix it together when we get to work tomorrow.
Cheers, John
✅ Figure: Good example - Nicely informing of a standards violation