The Demachina SWAT team have made available for download their Coding Guidelines and Conventions.

Over the years the members of the team have worked on many projects and technologies. To ensure the work that is delivered is consistent, easy to read and understand, all code adheres to a single unified convention that is described in this document.

The document contains conventions and guidelines for such technologies as Visual Basic, VBScript, JavaScript, HTML, T-SQL, PL/SQL, C#, ASP, ASP.NET and Java. For each language conventions are discussed such as how to document code, handling errors, performance bottlenecks, logging, formating code etc. However, it is not a tutorial that describes how to program in a particualr language as that is well outside the scope of this document.

Even though the subject matter described is very serious, at least to us, the document is written in a light-hearted manner. For more information see this blog.

Download conventions (PDF)

Please note that although the PDF version of the conventions can be downloaded for free, when the document is used for commercial purposes a payment will need to be made of $99,-. This will give you access to the MS-Word version of the document, which can then be changed to include company specific guidelines and conventions.