Bundt User's Manual · Bundt Toolset version 1.0.1.0

Versioning Models

A model always has a version number. You can increment a model's version number to keep track of its changes.

Details

A model's version number indicates whether this model newer or older as compared to another version.

Version number parts

A model's version number looks like this:

1.0.2.17

Version numbers are composed of four parts, separated by dots. Parts are numeric, and may each range from 0 to 65535. Each part has a specific meaning, from left to right:

  • The major part (1 in the example above) corresponds to very large changes in the model. Increase this only when you perform large changes that deeply alter the model and break backwards compatibility.
  • The minor part (0 in the example above) corresponds to significant changes in the model. Increase this only when you perform changes that alter the model significantly and break backwards compatibility.
  • The build part (2 in the example above) corresponds to small changes in the model. Increase this when you perform changes that alter a small part of the model and break backwards compatibility in a manner that is easy to fix.
  • The revision part (17 in the example above) corresponds to cosmetic changes in the model. Increase this when you perform changes that do not affect the structure of the model and do not break backwards compatibility.

Whenever you increase a part, reset the following ones to zero.

For example, if you rewrite the definition of a class to make it easier to understand, you would probably increase the revision number from 1.0.2.17 to 1.0.2.18. If you changed the name of a class, for example from Person to Individual, you would probably increase the build number from 1.0.2.17 to 1.0.3.0. If you added or deleted a few classes, or changed a couple of associations to point to another class, you would probably increase the minor number from 1.0.2.17 to 1.1.0.0. And, if you revamped your model completely, adding much content or deleting a significant amount of it, you would definitely increate the major number from 1.0.2.17 up to 2.0.0.0.

Using version numbers

Increasing a model's version number is usually optional. However, you are responsible to indicate changes to your model by correspondingly increasing its version number before you save it.

When you unseal a sealed model, you will need to increase its version number so that the resulting unsealed version can be clearly distinguished from the original sealed one.

Model version numbers can never be decreased.

See Also

Contents distributed under a Creative Commons Attribution 4.0 International License · About · Terms of Use · Contact Us · last updated on 08 October 2020