Skip to content

Commit b408c1b

Browse files
authored
Merge pull request #652 from stzn/upcoming
upcoming featureのセクションを追加
2 parents 8784f66 + b9076f9 commit b408c1b

File tree

1 file changed

+8
-0
lines changed

1 file changed

+8
-0
lines changed

Style.md

Lines changed: 8 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -160,6 +160,14 @@ API のシンボル名と一致するように、代わりに「追加(add)」
160160
161161
リファレンスでは、コンパイラがアクションを実行する実際の動作主である場合に具体的に言及しています。私たちはパーサ(parser)、レキサ(lexer)、オプティマイザ(optimizer)などのコンパイラの詳細を区別しません。
162162

163+
### 今後の機能(upcoming features)
164+
165+
[SE-0362: Piecemeal adoption of upcoming language improvements](https://github.com/apple/swift-evolution/blob/main/proposals/0362-piecemeal-future-features.md)の実装以降、一部の言語機能はデフォルトで有効になる前にオプトイン方式で利用可能です。
166+
167+
将来の機能に関するセクションまたは章の冒頭に、次のような注記を含めてください。
168+
169+
> 注: この言語機能は Swift *n* の一部となります。現在のバージョンの Swift でこの機能を有効にするには、機能識別子 `SomeFeatureIdentifier` を使用してください。将来の言語機能の有効化については、[将来の言語機能の有効化](https://github.com/swiftlang/swift-migration-guide/blob/main/Guide.docc/FeatureMigration.md)をご覧ください。
170+
163171
## トーン
164172

165173
一般的に、そして特にガイドは、楽しさが伝わるように書くべきです。本書内の例は簡単で、読みやすいものでなければなりません。つまり、現実的なコードが好まれ、多くの章で複数の例に共通の物語が織り込まれています。その連続した物語のつながりは、後々の変更をより大変にする可能性がありますが、章の流れが良くなり、全体としてよりよくまとまるため、総じて十分にそうする価値はあると思います。

0 commit comments

Comments
 (0)