swift-book
swift-book copied to clipboard
apple
The Swift Programming Language book
The shipping book uses a custom syntax for its tests; we preserved these as DocC comments in the Markdown source, but use regular Swift code blocks to render them without...
Right now, the grammar in Language Reference is implemented using plain code listings. The shipping book includes a custom presentation for the grammar, including cross-references between different grammar elements and...
When introducing new syntax for the first time, the book uses placeholder literals to show the customizable portion(s) of the syntax being introduced. Right now, these render as regular Swift...
The shipping book supports an offline reading experience with an ePUB version available on swift.org and on Apple Books. We should evaluate which formats we want to support going forward,...
When building the book, DocC understands the first paragraph of each chapter to be an abstract for that chapter, which it renders differently from the chapter's content. For example, in...
This reduces the places where content in the comment causes DocC to silently mis-parse the comment and content after it. The markdown parser for DocC first parses plain markdown syntax,...
Per discussion in the docs workgroup, it'd be good to have a preview version of the DocC output that we can all look at as we work toward publishing the...
The version of TSPL currently published using the pre-DocC toolchain styles each item in the definition of a grammar rule as a link to that item's own definition. The live...