swift-book icon indicating copy to clipboard operation
swift-book copied to clipboard

The Swift Programming Language book

Results 150 swift-book issues
Sort by recently updated
recently updated
newest added

Fixes: https://github.com/apple/swift-book/issues/193

### Location https://docs.swift.org/swift-book/documentation/the-swift-programming-language/closures ### Description The documentation page about Closures implies the C programming language has the concept of blocks. > Closures are self-contained blocks of functionality that can be...

Content issue

readers might be in doubt about the `open` access modifier, especially `internal` members, adding this part will explain this more and remove doubts. we can remove some parts of it...

Fixing punctuation around code examples to conform to the style guide. Only punctuation has changed.

The output uses using the POSIX ctags syntax, and enables "jump to definition" for DocC links and for syntactic categories in the formal grammar. From testing with a few different...

[This page](https://docs.swift.org/swift-book/documentation/the-swift-programming-language/opaquetypes/) of TSPL shows the example: ``` func `repeat`(shape: T, count: Int) -> some Collection { return Array(repeating: shape, count: count) } ``` Which is pretty useless; it should...

Content issue

### Location https://github.com/apple/swift-book/blob/main/TSPL.docc/ReferenceManual/Expressions.md?plain=1#L64 ### Description An in-out-expression is defined as being **&** identifier. This is incorrect, and can be seen on line 51 that it's meant to be **&** expression....

Content issue

### Location https://docs.swift.org/swift-book/documentation/the-swift-programming-language/closures#Capturing-Values ### Description Relevant twitter thread: https://twitter.com/krzyzanowskim/status/1712585805053473076 Currently, in the **Closures** section we only mention capture lists as a way to manage reference cycles, specifically relating to `self`....

Enhancement

Because of the way Swift-DocC works, the URL we publish to must change from to . We need to set up server-side redirects on Swift.org so that links to chapters...

Build issue
Good first issue