Skip to content

Commit c7e0d95

Browse files
committed
Add upcoming-features text to the style guide
Fixes: rdar://106105204 Reviewed-by: Robert Olsen <[email protected]>
2 parents d14ef11 + e824f88 commit c7e0d95

File tree

1 file changed

+19
-0
lines changed

1 file changed

+19
-0
lines changed

Style.md

Lines changed: 19 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -313,6 +313,25 @@ when it‘s the actual agent performing the action.
313313
We don’t distinguish between the parts of the compiler
314314
like the parser or the lexer or the optimizer.
315315

316+
## upcoming features
317+
318+
Starting with the implementation of
319+
[SE-0362: Piecemeal adoption of upcoming language improvements][SE-0362],
320+
some language features are available on an opt-in basis
321+
before being enabled by default.
322+
323+
At the beginning of a section or chapter about a future feature,
324+
include a note as follows.
325+
326+
> Note:
327+
> This language feature will be part of Swift *n*.
328+
> To enable it in current versions of Swift,
329+
> use the feature identifier `SomeFeatureIdentifier`.
330+
> For information about enabling future language features,
331+
> see [Enabling future language features](FIXME).
332+
333+
[SE-0362]: https://github.com/apple/swift-evolution/blob/main/proposals/0362-piecemeal-future-features.md
334+
316335
# Tone
317336

318337
In general, and especially in the guide,

0 commit comments

Comments
 (0)