migrateIfNeeded is undocumented

[boucher]

It seems like migrateIfNeeded should just be called by the package, but that doesn't seem to be the case, unless I'm missing it? If the expectation is that I should call it, it would be helpful to have that mentioned with some guidance on when.

[sindresorhus]

It's documented in the release notes. It's only relevant for upgrades.

[boucher]

I see, thanks! Though, I'm still slightly uncertain about what you mean when you say it's only needed for upgrades. If I were to install this now, while still targeting, say, macOS 11, it will still use the legacy system on any system older than macOS 13 and I should still call this all the time, right?