&gt; <i>We definitely need to do that with our APIs and designs (aka. more incremental refactoring).</i><p>Not with APIs we&#x27;ve shipped.  Then it becomes breaking changes that appear pointless to others.  Even when it&#x27;s logically worth it to go back and fix APIs, it&#x27;s rarely worth it practically.  If no one is using your APIs, then do whatever.  If your APIs are popular, you might find yourself in &quot;version next&quot; limbo like so many major projects that redesigned and couldn&#x27;t convince their users to follow.