When should I change the tlib-version of my tag library?

Question

I'm after guidelines on when I should change the tlib-version in the .tld of a tag library that I author.

Specifically I'm wondering if I should bump the version number if I add new tags to the library or if I should only do this if I make breaking changes to existing tags?

Answer 1

That's all up to you. I'd bump it in any way whenever you expand or alter the library. You can consider to split the version in a "major version" and a "minor version". E.g. 1.0, 1.1, 1.2, 2.0, 2.1, etc to distinguish between major and minor changes. E.g. just bump the minor version when you add new attributes and bump the major version when you add brand new tags and/or change the behaviour of existing tags.

At least, as long as every change is documented per version, the endusers don't really care about how the version numbers develops. It has only more potential benefits for the marketing.