Apple、包括的用語使用の義務付けを含むスタイルガイド更新

headless 曰く、

Appleは16日、ドキュメントやユーザーインターフェイスなどで使用する用語のガイドライン「Apple Style Guide」を更新した(Appleの告知、 The Registerの記事)。

更新版には「blacklist/whitelist」「master/slave」といった非包括的な用語の使用を禁止する項目が追加されている。blacklist/whitelistについては使用が禁じられ、文脈に応じて適切な代替用語を選ぶよう求めている。代替用語の例としては「deny list/allow list」「unapproved list/approved list」が挙げられている。

master/slaveに関しては、2つのデバイスやプロセスの関係を説明するために使用することが禁じられる。こちらも文脈に応じて適切な代替用語を選ぶよう求めており、代替として「primary/secondary」「primary/replica」「main/secondary」「host/client」といった例が挙げられている。

いずれの場合も、非包括的用語が変更不可能なコード内で使われていて、それに関するドキュメントを作成する場合は例外として認められる。ただし、例外となるのはユーザーがコードの通りに入力する必要がある部分のみで、その説明には代替用語を使用する必要がある。

包括的用語といえるかどうか微妙だが、「Asia Pacific」という用語を使用する場合に「Japan」を分けて列挙することを禁じる項目も追加されている。つまり、Asia PacificにはJapanが含まれているため、「Asia Pacific and Japan」という表記はガイドラインに違反するというわけだ。

blacklist/whitelistからdeny list/allow listへの置き換えはWWDC20で公開したベータ版ソフトウェアや開発者向けドキュメントで導入されており、Xcode 12のデフォルトSCMブランチ名はmasterからmainに置き換えられているという。今後、排他的用語を使用しているAPIに関しても、内部のコードベースで代替を導入した段階で非推奨にしていくとのことだ。