Home

The BW Coding Standards Wiki

Welcome to the The BW Coding Standards Wiki!

This is a place for TIBCO ActiveMatrix BusinessWorks™ (BW) developers to learn and collaborate on the establishment of coding standards for the BW platform.

Our view is that coding standards not only improves code maintainability, but also improves coding efficiency.

Without coding standards, developers have freedom of choice over a great many aspects of their work: what to name things, how to design the project structure, etc. But this choice comes with the cost of having to make many decisions. For instance, without a XML Schema standard regarding when to use attributes and when to use elements, each time a new schema is developed, you have to spend time deliberating on the choice.

Coding standards give you freedom from choice. With freedom from choice you don’t have to decide if you should use PascalCase, camelCase or Under_Score for process names. You don’t have to decide if a particular node in your XML schema should be an attribute or an element. You just apply the standard and the decision is made for you. This results in increased efficiency as you are able to focus on delivering features, rather than making many peripheral decisions.

Style Guides

Here at the BW Coding Standards Wiki, we don't believe there is a single set of standards that are perfect for everyone. Standards that work for some teams will be inappropriate for others, so we don't try to maintain a single global standard. Instead you will find a number of Style Guides (we'll actually, there's just the The Sydney Style Guide at the moment, but we hope more will come).

The intention is that each style guide can evolve and be managed independently, but at the same time be able to cross pollinate each other with good standards. If you don't find a style guide that suites your needs, then please create your own, pick and choose which of the the existing standards you would like to include and add your own.

Current Style Guides

• The Sydney Style Guide

BW 5 and 6

We recognise there are significant differences between BW 5 and BW 6 and standards for one will not allways apply to the other. While the future is obviously BW 6, BW 5 is going to be around for a long time, so the BW Coding Standards Wiki supports and encourages standards for both and ask the maintainer(s) of each standard to clear indicate the version(s) the standard applies to.