search

macvim-dev / macvim

Vim - the text editor - for macOS
https://macvim.org
Vim License
7.47k stars 680 forks source link

Change "Preferences" to "Settings" in documentation #1323

Closed ychin closed 1 year ago

ychin commented 1 year ago

In macOS 13 Ventura, the general terminology of "Preferences" has been renamed to "Settings". The main menu's "Preferences…" item is automatically renamed to "Settings…" by the OS when building against the macOS 13 SDK, but we still need to update documentation to match.

eirnym commented 1 year ago

Would it break backward compatibility with older macOS versions?

ychin commented 1 year ago

I don't see why it would. It's documentation only.

eirnym commented 1 year ago

Did menu name change on a previous macOS if you build on a newer one?

ychin commented 1 year ago

The OS will automatically change it to "Settings…" in macOS 13, but it will still say "Preferences…" in macOS 12.

eirnym commented 1 year ago

So for the users who didn't upgrade the system, documentation will be at least confusing

ychin commented 1 year ago

Yes, and that will be a little annoying. But I don't think it's worth our time to maintain multiple versions of the documentation, and it's not useful to slap "Settings / Preferences" everywhere in the documentation. Given the choice between documenting the new and up-to-date versus the old terminology, we pick the new one. Sucks for users of older OS versions but honestly at this point I would hope they know what Preferences is as they would have been using macOS for a while. I can add a clarification at one spot (the beginning of "3. Settings") but otherwise it will say Settings everywhere.

eirnym commented 1 year ago

I agree with you about maintenance. A little word on system differences will be sufficient