TLDR; I'm proposing to standardize on US English in our public-facing
documentation.

I proposed an MR a while back that changed the only occurrence of the
UK English spelling "optimisation" for the US English spelling
"optimization", which is already used 34 times in the docs. I've done
similar changes in the past.

But this time Ian brought up the good point that picking a preferred
language should probably be done using group consensus on the mailing
list than just picking what's currently most popular.

So, I hereby propose to pick US English as our default language for
user-facing documentation.

I'm not proposing to force anyone to use a particular English variant
for things like comments, commit messages or variable names. I don't
think there's much value in enforcing that, and I think it'd be
perfectly fine if any particular driver wanted to pick a particular
variant of English.

The main reason I want to standardize on an English variant is that I'm
trying create a word-list for domain-specific/technical language to
detect spelling mistakes in the docs more easily. And not having to add
both US and UK English words makes this list easier to maintain. I'm
not planning on going 100% systematically though the dictionary to
detect UK English words that might be in my system dictionary, just to
fix the words that currently cause me (a tiny amount of) pain ;)

The main reason why I'm proposing US English over for instance UK
English is that this seems to be the dominant variant currently in the
documentation. So it seems like the pragmatic choice to me.

Thoughts? Any objections to sticking to US English in the docs?

The MR in question:
https://gitlab.freedesktop.org/mesa/mesa/-/merge_requests/8572

Ian's response:
https://gitlab.freedesktop.org/mesa/mesa/-/merge_requests/8572#note_808593

Previous changes:
https://gitlab.freedesktop.org/mesa/mesa/-/merge_requests/6864
https://gitlab.freedesktop.org/mesa/mesa/-/merge_requests/6894


_______________________________________________
mesa-dev mailing list
mesa-dev@lists.freedesktop.org
https://lists.freedesktop.org/mailman/listinfo/mesa-dev

Reply via email to