@@ -26,7 +26,7 @@ just surface level syntax for concepts they already know from other languages.
2626commonly referred to as “the guide”,
2727leads you through the Swift language in a pedagogically useful, linear order.
2828It doesn't promise to show you every feature of
29- the language or the standard library,
29+ the language or the Swift standard library,
3030and it hand-waves over the exact details
3131of some of the more complicated underlying bits.
3232The guide leans on the reference to resolve the nitty-gritty detail questions
@@ -44,12 +44,12 @@ are already discussed in previous chapters.
4444that the early chapters of the guide need
4545— many topics from “The Basics” are covered again later in the guide in more detail.
4646
47- The guide includes types from the standard library for two reasons:
47+ The guide includes types from the Swift standard library for two reasons:
4848they’re needed by an explanation of a language concept,
4949or they’re so common that readers wouldn’t
5050be able to build anything useful without them.
5151The latter reason includes a judgement call.
52- When new types are introduced in the standard library,
52+ When new types are introduced in the Swift standard library,
5353we usually need to discuss whether & where to add them to TSPL.
5454
5555The guide can be broken down into three major chunks:
@@ -169,7 +169,7 @@ For example:
169169> custom classes and structures don’t have an implementation of
170170> the * equal to* operator (` == ` ) or * not equal to* operator (` != ` ).
171171> You usually implement the ` == ` operator,
172- > and use the standard library’s default implementation of the ` != ` operator
172+ > and use the Swift standard library’s default implementation of the ` != ` operator
173173> that negates the result of the ` == ` operator.
174174> There are two ways to implement the ` == ` operator.
175175
@@ -247,6 +247,17 @@ By design, actors specifically *avoid* having shared mutable state —
247247their mutable state is private,
248248and accessible only through the actor's (async) methods.
249249
250+ ## standard library
251+
252+ Spell out in full as “the Swift standard library“ on the first use.
253+ If context already makes it clear
254+ and repeating the full name becomes wordy,
255+ you can shorted it to just “the standard library”
256+ in continued discussion.
257+ (We currently don‘t have any examples of doing that.)
258+
259+ Not “stdlib“ or “the stdlib“.
260+
250261## spawn, start
251262
252263Use “add” instead to refer to creating a new task,
0 commit comments