apple
The Result Builders section should be moved out of the Advanced Operators chapter and into its own chapter
Location
https://docs.swift.org/swift-book/documentation/the-swift-programming-language/advancedoperators#Result-Builders
Description
Because result builders are not operators.
Relevant forums topic before TSPL was open-source: https://forums.swift.org/t/move-the-result-builders-section-in-tspl-to-its-own-chapter/50056
Correction
No response
Where do you suggest moving it?
When I added this section, we had a long discussion about where to put this content. There isn't anyplace in TSPL that's an exact fit. Part of the thinking at the time was that we could move the Advanced Operators chapter towards more of a general scope to include DSLs.
Instead of fitting it with something else, why not just have Result Builders be its own chapter? Is the discussion about fitting it somewhere somewhat about its place in the progressive disclosure of complexity?
I'm a fan of turning Advanced Operators into something more of an Advanced Syntax (or similar) chapter.
Seems like the argument against putting result builders in their own chapter is that there perhaps isn't enough to say about them to warrant a whole chapter?
Seems like the argument against putting result builders in their own chapter is that there perhaps isn't enough to say about them to warrant a whole chapter?
Judging by the length of the proposal document, there shouldn't be a shortage of things to say about it. And even if there isn't much, it can just be a short chapter, like the Nested Types chapter.