Skip to content

Commit 7801a94

Browse files
committed
Revise package explanation for clarity
- Starting with the most relevant facts - Linking to a more general API reference - Avoiding passive voice
1 parent 40fbd2f commit 7801a94

File tree

1 file changed

+9
-8
lines changed

1 file changed

+9
-8
lines changed

TSPL.docc/LanguageGuide/AccessControl.md

Lines changed: 9 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -45,14 +45,15 @@ A *source file* is a single Swift source code file within a module
4545
Although it's common to define individual types in separate source files,
4646
a single source file can contain definitions for multiple types, functions, and so on.
4747

48-
A *package* is a group of modules and source files,
49-
with boundaries that are defined by the build system.
50-
The package name isn't part of your Swift source code,
51-
but does appear in your configuration for the build system.
52-
For example, if your use Swift Package Manager to build your code,
53-
you define the package name using [`Package`][] in your package manifest.
54-
55-
[`Package`](https://developer.apple.com/documentation/PackageDescription/Package)
48+
A *package* is a group of modules that you develop as a unit.
49+
You define the modules that form a package
50+
as part of configuring the build system you're using,
51+
not as part of your Swift source code.
52+
For example, if you use Swift Package Manager to build your code,
53+
you define a package in your `Package.swift` file
54+
using APIs from the [PackageDescription][] module.
55+
56+
[PackageDescription](https://developer.apple.com/documentation/packagedescription)
5657

5758
## Access Levels
5859

0 commit comments

Comments
 (0)