The Best API Change Is the One Nobody Notices

Scene-aware custom containers in Factory, and the design that let the existing API stay put…

The Best API Change Is the One Nobody Notices

Scene-aware custom containers in Factory, and the design that let the existing API stay put…

Michael Long
Michael Long in The Swift Cooperative
  ∙  
October 22, 2026
  ∙  
6 min read
Member-only content
  ∙  
View on Medium
Factory logo by Michael Long

Factory logo by Michael Long

Every library author eventually learns that new capability costs new API.

A new feature means a new parameter, a new generic, a new protocol requirement, and a migration guide for everyone who already depends on you. It’s practically a law of nature.

Sometimes.

In my last article I introduced scene-based injection for Factory’s default container. It left a gap, and closing that gap looked like it was going to break things. It didn’t, and the reason why is worth a look.

The Gap

Here’s what scenes gave us. Install a Container at the root of each window, publish it in the environment…

Continue reading
This is a member-only story and can only be read on Medium.
Become a Medium member
Sent to sikubaycom.s3cr3tz@blogger.com by Michael Long on Medium
Unsubscribe from this writer's email notifications
Manage your email settings

3500 South DuPont Highway, Suite IQ-101, Dover, DE 19901
Careers·Help Center·Privacy Policy·Terms of service