Identify Released Language Features Not Yet Documented in TSPL
Opened this issue · 0 comments
Location
Between
and
https://docs.swift.org/swift-book/documentation/the-swift-programming-language/summaryofthegrammar
Description
It is proposed that the attached be added as the final subsection of the language reference prior to Summary of the Grammar. The set of referenced SE's should be reviewed as there may be some omissions. Further, as this would not be included until the next release, some of those SE's may have been documented in the release and they should be removed from the list. Also, some SE's in that release may need to be added to this list. The list should also be reviewed and updated for each subsequent TSPL release.
Motivation
The Swift Programming Language serves as the de facto language standard. On www.swift.org, the book is even mentioned with:
Language Reference: The Swift Programming Language (TSPL) book is the authoritative reference for Swift, offering a guided tour, a comprehensive guide, and a formal reference of the language.
So, for a given release of the language, the book should be complete. But as indicated in the attachment, that is not always possible. But by identifying within the book itself what isn't yet documented and providing links to where relavent material may be found, the book does provide a complete reference of the language. As each topic listed in the attachment is addressed, it may be removed, and as new implemented yet undocumented features are released, they may be added. As a side-benefit, this may also encourage others to participate in joining in the effort to maintain the book.
Alternatives Considered
Post the attachment (or some version thereof) on the website instead of in the book. But by including it in the book, it is more likely to be read.