Add chapter abstracts (#47)

amartini51 · web-flow · commit aa3829e8a080 · 2022-10-31T11:43:32.000-07:00
Fixes #1
diff --git a/Sources/TSPL/TSPL.docc/GuidedTour/AboutSwift.md b/Sources/TSPL/TSPL.docc/GuidedTour/AboutSwift.md
@@ -2,6 +2,8 @@
 
 # About Swift
 
+Understand the high-level goals of the language.
+
 Swift is a fantastic way to write software,
 whether it’s for phones, desktops, servers,
 or anything else that runs code.
diff --git a/Sources/TSPL/TSPL.docc/GuidedTour/Compatibility.md b/Sources/TSPL/TSPL.docc/GuidedTour/Compatibility.md
@@ -2,6 +2,8 @@
 
 # Version Compatibility
 
+Learn what functionality is available in older language modes.
+
 This book describes Swift 5.7,
 the default version of Swift that's included in Xcode 14.
 You can use Xcode 14 to build targets
diff --git a/Sources/TSPL/TSPL.docc/GuidedTour/GuidedTour.md b/Sources/TSPL/TSPL.docc/GuidedTour/GuidedTour.md
@@ -2,6 +2,8 @@
 
 # A Swift Tour
 
+Explore the features and syntax of Swift.
+
 
 
 Tradition suggests that the first program in a new language
diff --git a/Sources/TSPL/TSPL.docc/LanguageGuide/AccessControl.md b/Sources/TSPL/TSPL.docc/LanguageGuide/AccessControl.md
@@ -2,6 +2,8 @@
 
 # Access Control
 
+Manage the visibility of code by declaration, file, and module.
+
 *Access control* restricts access to parts of your code
 from code in other source files and modules.
 This feature enables you to hide the implementation details of your code,
diff --git a/Sources/TSPL/TSPL.docc/LanguageGuide/AdvancedOperators.md b/Sources/TSPL/TSPL.docc/LanguageGuide/AdvancedOperators.md
@@ -2,6 +2,8 @@
 
 # Advanced Operators
 
+Define custom operators, perform bitwise operations, and use builder syntax.
+
 In addition to the operators described in <doc:BasicOperators>,
 Swift provides several advanced operators that perform more complex value manipulation.
 These include all of the bitwise and bit shifting operators you will be familiar with
diff --git a/Sources/TSPL/TSPL.docc/LanguageGuide/AutomaticReferenceCounting.md b/Sources/TSPL/TSPL.docc/LanguageGuide/AutomaticReferenceCounting.md
@@ -2,6 +2,8 @@
 
 # Automatic Reference Counting
 
+Model the lifetime of objects and their relationships.
+
 Swift uses *Automatic Reference Counting* (ARC)
 to track and manage your app's memory usage.
 In most cases, this means that memory management “just works” in Swift,
diff --git a/Sources/TSPL/TSPL.docc/LanguageGuide/BasicOperators.md b/Sources/TSPL/TSPL.docc/LanguageGuide/BasicOperators.md
@@ -2,6 +2,8 @@
 
 # Basic Operators
 
+Perform assignment, arithmetic, comparison, and Boolean operations.
+
 An *operator* is a special symbol or phrase that you use to
 check, change, or combine values.
 For example, the addition operator (`+`) adds two numbers,
diff --git a/Sources/TSPL/TSPL.docc/LanguageGuide/ClassesAndStructures.md b/Sources/TSPL/TSPL.docc/LanguageGuide/ClassesAndStructures.md
@@ -2,6 +2,8 @@
 
 # Structures and Classes
 
+Model custom types that encapsulate data.
+
 *Structures* and *classes* are general-purpose,
 flexible constructs that become the building blocks of your program's code.
 You define properties and methods to add functionality to your structures and classes
diff --git a/Sources/TSPL/TSPL.docc/LanguageGuide/Closures.md b/Sources/TSPL/TSPL.docc/LanguageGuide/Closures.md
@@ -2,6 +2,8 @@
 
 # Closures
 
+Group code that executes together, without creating a named function.
+
 *Closures* are self-contained blocks of functionality
 that can be passed around and used in your code.
 Closures in Swift are similar to blocks in C and Objective-C
diff --git a/Sources/TSPL/TSPL.docc/LanguageGuide/CollectionTypes.md b/Sources/TSPL/TSPL.docc/LanguageGuide/CollectionTypes.md
@@ -2,6 +2,8 @@
 
 # Collection Types
 
+Organize data using arrays, sets, and dictionaries.
+
 Swift provides three primary *collection types*,
 known as arrays, sets, and dictionaries,
 for storing collections of values.
diff --git a/Sources/TSPL/TSPL.docc/LanguageGuide/Concurrency.md b/Sources/TSPL/TSPL.docc/LanguageGuide/Concurrency.md
@@ -2,6 +2,8 @@
 
 # Concurrency
 
+Perform asynchronous operations.
+
 Swift has built-in support for writing asynchronous and parallel code
 in a structured way.
 *Asynchronous code* can be suspended and resumed later,
diff --git a/Sources/TSPL/TSPL.docc/LanguageGuide/ControlFlow.md b/Sources/TSPL/TSPL.docc/LanguageGuide/ControlFlow.md
@@ -2,6 +2,8 @@
 
 # Control Flow
 
+Structure code with branches, loops, and early exits.
+
 Swift provides a variety of control flow statements.
 These include `while` loops to perform a task multiple times;
 `if`, `guard`, and `switch` statements
diff --git a/Sources/TSPL/TSPL.docc/LanguageGuide/Deinitialization.md b/Sources/TSPL/TSPL.docc/LanguageGuide/Deinitialization.md
@@ -2,6 +2,8 @@
 
 # Deinitialization
 
+Release resources that require custom cleanup.
+
 A *deinitializer* is called immediately before a class instance is deallocated.
 You write deinitializers with the `deinit` keyword,
 similar to how initializers are written with the `init` keyword.
diff --git a/Sources/TSPL/TSPL.docc/LanguageGuide/Enumerations.md b/Sources/TSPL/TSPL.docc/LanguageGuide/Enumerations.md
@@ -2,6 +2,8 @@
 
 # Enumerations
 
+Model custom types that define a list of possible values.
+
 An *enumeration* defines a common type for a group of related values
 and enables you to work with those values in a type-safe way within your code.
 
diff --git a/Sources/TSPL/TSPL.docc/LanguageGuide/ErrorHandling.md b/Sources/TSPL/TSPL.docc/LanguageGuide/ErrorHandling.md
@@ -2,6 +2,8 @@
 
 # Error Handling
 
+Respond to and recover from errors.
+
 *Error handling* is the process of responding to
 and recovering from error conditions in your program.
 Swift provides first-class support for
diff --git a/Sources/TSPL/TSPL.docc/LanguageGuide/Extensions.md b/Sources/TSPL/TSPL.docc/LanguageGuide/Extensions.md
@@ -2,6 +2,8 @@
 
 # Extensions
 
+Add functionality to an existing type.
+
 *Extensions* add new functionality to an existing
 class, structure, enumeration, or protocol type.
 This includes the ability to extend types
diff --git a/Sources/TSPL/TSPL.docc/LanguageGuide/Functions.md b/Sources/TSPL/TSPL.docc/LanguageGuide/Functions.md
@@ -2,6 +2,8 @@
 
 # Functions
 
+Define and call functions, label their arguments, and use their return values.
+
 *Functions* are self-contained chunks of code that perform a specific task.
 You give a function a name that identifies what it does,
 and this name is used to “call” the function to perform its task when needed.
diff --git a/Sources/TSPL/TSPL.docc/LanguageGuide/Generics.md b/Sources/TSPL/TSPL.docc/LanguageGuide/Generics.md
@@ -2,6 +2,8 @@
 
 # Generics
 
+Write code that works for multiple types and specify requirements for those types.
+
 *Generic code* enables you to write flexible, reusable functions and types
 that can work with any type, subject to requirements that you define.
 You can write code that avoids duplication
diff --git a/Sources/TSPL/TSPL.docc/LanguageGuide/Inheritance.md b/Sources/TSPL/TSPL.docc/LanguageGuide/Inheritance.md
@@ -2,6 +2,8 @@
 
 # Inheritance
 
+Subclass to add or override functionality.
+
 A class can *inherit* methods, properties, and other characteristics
 from another class.
 When one class inherits from another,
diff --git a/Sources/TSPL/TSPL.docc/LanguageGuide/Initialization.md b/Sources/TSPL/TSPL.docc/LanguageGuide/Initialization.md
@@ -2,6 +2,8 @@
 
 # Initialization
 
+Set the initial values for a type's stored properties and perform one-time setup.
+
 *Initialization* is the process of preparing an instance of
 a class, structure, or enumeration for use.
 This process involves setting an initial value for each stored property on that instance
diff --git a/Sources/TSPL/TSPL.docc/LanguageGuide/MemorySafety.md b/Sources/TSPL/TSPL.docc/LanguageGuide/MemorySafety.md
@@ -2,6 +2,8 @@
 
 # Memory Safety
 
+Structure your code to avoid conflicts when accessing memory.
+
 By default, Swift prevents unsafe behavior from happening in your code.
 For example,
 Swift ensures that variables are initialized before they're used,
diff --git a/Sources/TSPL/TSPL.docc/LanguageGuide/Methods.md b/Sources/TSPL/TSPL.docc/LanguageGuide/Methods.md
@@ -2,6 +2,8 @@
 
 # Methods
 
+Define and call functions that are part of an instance or type.
+
 *Methods* are functions that are associated with a particular type.
 Classes, structures, and enumerations can all define instance methods,
 which encapsulate specific tasks and functionality for working with an instance of a given type.
diff --git a/Sources/TSPL/TSPL.docc/LanguageGuide/NestedTypes.md b/Sources/TSPL/TSPL.docc/LanguageGuide/NestedTypes.md
@@ -2,6 +2,8 @@
 
 # Nested Types
 
+Define one data type inside of another data type.
+
 Enumerations are often created to support a specific class or structure's functionality.
 Similarly, it can be convenient to define utility classes and structures
 purely for use within the context of a more complex type.
diff --git a/Sources/TSPL/TSPL.docc/LanguageGuide/OpaqueTypes.md b/Sources/TSPL/TSPL.docc/LanguageGuide/OpaqueTypes.md
@@ -2,6 +2,8 @@
 
 # Opaque Types
 
+Hide implementation details about a value's type.
+
 A function or method with an opaque return type
 hides its return value's type information.
 Instead of providing a concrete type as the function's return type,
diff --git a/Sources/TSPL/TSPL.docc/LanguageGuide/OptionalChaining.md b/Sources/TSPL/TSPL.docc/LanguageGuide/OptionalChaining.md
@@ -2,6 +2,8 @@
 
 # Optional Chaining
 
+Access members of an optional value without unwrapping.
+
 *Optional chaining* is a process for querying and calling
 properties, methods, and subscripts on an optional that might currently be `nil`.
 If the optional contains a value,
diff --git a/Sources/TSPL/TSPL.docc/LanguageGuide/Properties.md b/Sources/TSPL/TSPL.docc/LanguageGuide/Properties.md
@@ -2,6 +2,8 @@
 
 # Properties
 
+Access stored and computed values that are part of an instance or type.
+
 *Properties* associate values with a particular class, structure, or enumeration.
 Stored properties store constant and variable values as part of an instance,
 whereas computed properties calculate (rather than store) a value.
diff --git a/Sources/TSPL/TSPL.docc/LanguageGuide/Protocols.md b/Sources/TSPL/TSPL.docc/LanguageGuide/Protocols.md
@@ -2,6 +2,8 @@
 
 # Protocols
 
+Define requirements that conforming types must implement.
+
 A *protocol* defines a blueprint of
 methods, properties, and other requirements
 that suit a particular task or piece of functionality.
diff --git a/Sources/TSPL/TSPL.docc/LanguageGuide/StringsAndCharacters.md b/Sources/TSPL/TSPL.docc/LanguageGuide/StringsAndCharacters.md
@@ -2,6 +2,8 @@
 
 # Strings and Characters
 
+Store and manipulate text.
+
 A *string* is a series of characters,
 such as `"hello, world"` or `"albatross"`.
 Swift strings are represented by the `String` type.
diff --git a/Sources/TSPL/TSPL.docc/LanguageGuide/Subscripts.md b/Sources/TSPL/TSPL.docc/LanguageGuide/Subscripts.md
@@ -2,6 +2,8 @@
 
 # Subscripts
 
+Access the elements of a collection.
+
 Classes, structures, and enumerations can define *subscripts*,
 which are shortcuts for accessing the member elements of a collection, list, or sequence.
 You use subscripts to set and retrieve values by index without needing
diff --git a/Sources/TSPL/TSPL.docc/LanguageGuide/TheBasics.md b/Sources/TSPL/TSPL.docc/LanguageGuide/TheBasics.md
@@ -2,6 +2,8 @@
 
 # The Basics
 
+Work with common kinds of data and write basic syntax.
+
 Swift is a programming language for iOS, macOS, watchOS, and tvOS app development.
 If you have experience developing in C or Objective-C,
 many parts of Swift will be familiar to you.
diff --git a/Sources/TSPL/TSPL.docc/LanguageGuide/TypeCasting.md b/Sources/TSPL/TSPL.docc/LanguageGuide/TypeCasting.md
@@ -2,6 +2,8 @@
 
 # Type Casting
 
+Determine a value's runtime type and give it more specific type information.
+
 *Type casting* is a way to check the type of an instance,
 or to treat that instance as a different
 superclass or subclass from somewhere else in its own class hierarchy.
diff --git a/Sources/TSPL/TSPL.docc/ReferenceManual/AboutTheLanguageReference.md b/Sources/TSPL/TSPL.docc/ReferenceManual/AboutTheLanguageReference.md
@@ -2,6 +2,8 @@
 
 # About the Language Reference
 
+Read the notation that the formal grammar uses.
+
 This part of the book describes the formal grammar of the Swift programming language.
 The grammar described here is intended to help you understand the language in more
 detail, rather than to allow you to directly implement a parser or compiler.
diff --git a/Sources/TSPL/TSPL.docc/ReferenceManual/Attributes.md b/Sources/TSPL/TSPL.docc/ReferenceManual/Attributes.md
@@ -2,6 +2,8 @@
 
 # Attributes
 
+Add information to declarations and types.
+
 There are two kinds of attributes in Swift ---
 those that apply to declarations and those that apply to types.
 An attribute provides additional information about the declaration or type.
diff --git a/Sources/TSPL/TSPL.docc/ReferenceManual/Declarations.md b/Sources/TSPL/TSPL.docc/ReferenceManual/Declarations.md
@@ -2,6 +2,8 @@
 
 # Declarations
 
+Introduce types, operators, variables, and other names and constructs.
+
 A *declaration* introduces a new name or construct into your program.
 For example, you use declarations to introduce functions and methods,
 to introduce variables and constants,
diff --git a/Sources/TSPL/TSPL.docc/ReferenceManual/Expressions.md b/Sources/TSPL/TSPL.docc/ReferenceManual/Expressions.md
@@ -2,6 +2,8 @@
 
 # Expressions
 
+Access, modify, and assign values.
+
 In Swift, there are four kinds of expressions:
 prefix expressions, infix expressions, primary expressions, and postfix expressions.
 Evaluating an expression returns a value,
diff --git a/Sources/TSPL/TSPL.docc/ReferenceManual/GenericParametersAndArguments.md b/Sources/TSPL/TSPL.docc/ReferenceManual/GenericParametersAndArguments.md
@@ -2,6 +2,8 @@
 
 # Generic Parameters and Arguments
 
+Generalize declarations to abstract away concrete types.
+
 This chapter describes parameters and arguments for generic types, functions, and
 initializers. When you declare a generic type, function, subscript, or initializer,
 you specify the type parameters that the generic type, function, or initializer
diff --git a/Sources/TSPL/TSPL.docc/ReferenceManual/LexicalStructure.md b/Sources/TSPL/TSPL.docc/ReferenceManual/LexicalStructure.md
@@ -2,6 +2,8 @@
 
 # Lexical Structure
 
+Use the lowest-level components of the syntax.
+
 The *lexical structure* of Swift describes what sequence of characters
 form valid tokens of the language.
 These valid tokens form the lowest-level building blocks of the language
diff --git a/Sources/TSPL/TSPL.docc/ReferenceManual/Patterns.md b/Sources/TSPL/TSPL.docc/ReferenceManual/Patterns.md
@@ -2,6 +2,8 @@
 
 # Patterns
 
+Match and destructure values.
+
 A *pattern* represents the structure of a single value
 or a composite value.
 For example, the structure of a tuple `(1, 2)` is a comma-separated list of two
diff --git a/Sources/TSPL/TSPL.docc/ReferenceManual/Statements.md b/Sources/TSPL/TSPL.docc/ReferenceManual/Statements.md
@@ -2,6 +2,8 @@
 
 # Statements
 
+Structure groups of expressions and control their behavior.
+
 In Swift, there are three kinds of statements: simple statements, compiler control statements,
 and control flow statements.
 Simple statements are the most common and consist of either an expression or a declaration.
diff --git a/Sources/TSPL/TSPL.docc/ReferenceManual/Types.md b/Sources/TSPL/TSPL.docc/ReferenceManual/Types.md
@@ -2,6 +2,8 @@
 
 # Types
 
+Use built-in nominal and structural types.
+
 In Swift, there are two kinds of types: named types and compound types.
 A *named type* is a type that can be given a particular name when it's defined.
 Named types include classes, structures, enumerations, and protocols.
diff --git a/Sources/TSPL/TSPL.docc/RevisionHistory/RevisionHistory.md b/Sources/TSPL/TSPL.docc/RevisionHistory/RevisionHistory.md
@@ -2,6 +2,8 @@
 
 # Document Revision History
 
+Review the recent changes to this book.
+
 **2022-06-06**
 
 - Updated for Swift 5.7.
