Documenting Coding Standards - Less is More

A colleague and I were recently invited to provide feedback on a client's coding standards and were sent a 60+ page document to review. In preparation for the meeting I diligently started to go through each section providing comments and suggestions as I went. But after about page 30 my concentration began to wane and my comments grew more and more sparse. The moral of this story... If someone that's being paid to review your coding standards is struggling to get through them then you can bet your bottom dollar your development team won't be reading them either. This post reflects on the things to consider when documenting your company's standards.