https://nalar.dev/tags/versioning/ Recent content in Versioning on Nalar Hugo en-us Fri, 04 Sep 2026 00:00:00 +0700 https://nalar.dev/versioning-contracts-not-just-releases/ Fri, 04 Sep 2026 00:00:00 +0700 https://nalar.dev/versioning-contracts-not-just-releases/ <p>A version number is useful only when its consumers can make a decision from it.</p> <p>Suppose a library changes from <code>2.4.1</code> to <code>2.5.0</code>. A developer considering the upgrade wants to know something practical: can existing code keep working, or must it change? The answer does not come from how much code the maintainer edited. It comes from whether the release changed a <strong>contract that consumers depend on</strong>.</p> <p>That contract includes more than function names. It can include accepted inputs, returned values, error behavior, configuration, file formats, command-line options, extension points, and other observable behavior that the project promises to preserve.</p>