Coding Style Guidelines

Scott W. Ambler + Associates
Home | Articles | Books | IT Surveys | Podcasts | Contact Us | Announcements | Site Map
Elements of C# Style One of the easiest things that you can do to improve the quality of the source code produced by your team, and better yet your organization, is to adopt a simple set of coding standards. Extreme Programmers (XPers) understand that this is so important to do that "Coding Standards" is one of the core practices of XP. This page provides links to web pages and to good books which you can use to base your own coding standards on.

Table of Contents

Are Developers Actually Following Guidelines?

For the most part, things could be better (then again, they could be a lot worse too). As you can see in Figure 1, which depicts results from the 2009 IT Project Management and Governance Survey, a little more than half of respondents indicated that the developers on their IT project teams were following some sort of coding conventions, although only 19% were following enterprise/corporate conventions. When it specifically comes to agile teams the situation isn't much better. As you can see in Figure 2, which depicts results from the 2010 How Agile Are You? Survey, 58% of respondents on "agile teams" indicated that development guidelines/standards existing and 54% (of the total) indicated that they were following the conventions. That survey didn't explore whether they were project-level or enterprise-level conventions.

Figure 1. Development team's approach to following coding conventions.

Common coding convention application

Figure 2. Organization and governance strategies adopted by agile teams.

Agile Criterion: Self organization

Web Pages

Books

C++ Coding Standards Elements of C# Style Elements of Java Style Oracle PL/SQL Best Practices Perl Best Practices Practical Guidelines for VB and C# Smalltalk With Style Web Standards Solutions

Other Important Resources

Elements of UML Style

Tips

  1. Remember Ambler's Rule of Standards: Industry standards are better than corporate standards, corporate standards are better than project standards, project standards are better than personal standards which are better than no standards at all.
  2. Having said that, you should tailor your guidelines/standards to meet your own needs.
  3. Base guidelines on practice, not theory.
  4. The most successful guidelines are often adopted on a grass roots basis, they are not inflicted on developers from above.

Email a Suggestion to Me

If you know of a good page or book that I've missed, please email me at send an email to me at so I can add it. Thanks in advance.

Let Us Help

We actively work with clients around the world to improve their information technology (IT) practices, typically in the role of mentor/coach, team lead, or trainer. A full description of what we do, and how to contact us, can be found at Scott W. Ambler + Associates.


Disciplined Agile Delivery: The Foundation for Scaling Agile Agile Modeling: Practices for Scaling Agile Agile Data: Practices for Scaling Agile EnterpriseUP: Agility at Scale AgileUP: Towards Disciplined Agile DeliveryAmbysoft Inc. Software Development Practices Advisor Scott Ambler + Associates Follow @scottwambler on Twitter!


Copyright 2005-2012 Scott W. Ambler

This site owned by Ambysoft Inc.