liveBook · Manning

Versioning

As explained in Designing AI Systems

The systematic identification and preservation of successive versions of software, data, models, or configuration.

Versioning lets software capabilities evolve without forcing every dependent application to change at once. Keep related workflows independently deployable, and keep multiple tool versions available so applications can migrate on their own schedules. section 2.2.3 section 6.2.2

A managed tool registry can make version changes predictable:

  • Use semantic versions: major releases mark breaking changes, minor releases add compatible functionality, and patch releases fix bugs. Reject incompatible changes unless they use a major version. section 6.2.2
  • Let applications pin version constraints while old and new versions coexist. Deprecate retiring versions, communicate migration guidance, and allow existing applications time to move. section 6.2.2
  • Deploy workflows independently so teams can run versions simultaneously and shift traffic gradually without coordinating unrelated releases. section 2.2.3
Listing 6.10 Version-constrained tool discovery
tools = platform.tools.discover(
    namespace="healthcare.scheduling.*",
    version_constraint="^1.0.0"    #A
)
 
tools = platform.tools.discover(
    namespace="healthcare.scheduling.*",
    version_constraint=">=1.0.0 <3.0.0"    #B
)

These discovery calls show two ways to constrain which tool versions an application can use. section 6.2.2

How Designing AI Systems covers it

How deep it goes
Defines semantic-version compatibility, version pinning, and deprecation, then describes registry enforcement and migration periods.
Examples
Uses a scheduling tool with changing parameters and independently deployed workflows running versions 1.0 and 2.0.
What you can do after
Operate/configure tool registries with version constraints, compatibility checks, and structured deprecation.
How it connects
Connects semantic versioning with tool registries, independent deployment, and gradual migration.

Also explained in

Compare how 36 books explain versioning →

Related concepts

This explainer was generated by Manning's knowledge graph from the text of Designing AI Systems. The section links point to the parts of the book it draws on.