The new documentation section of SO is cool. It fills a needed gap.
However, we need some sort of mechanism for adding comments to the user-contributed examples.
Here's why:
In the section on the Swift programming language, there is a subsection on closures, and a sub-subsection called "Passing closures into functions"
That sub-subsection has a sub-sub-subsection titled "@noescape parameters". That bit is correct for Swift 2. However, with the release of Swift 3, the semantics of closures have changed. Now, instead of closures being escaped by default, they are not escaped by default, and you have to mark escaping closures using the new "@escaping" tag.
I'd like to add a comment to that section so the author can update it to reflect the new semantics and syntax of Swift 3.
Also, a question:
How do you gain edit authority for documentation posts? And for those who don't yet have edit authority, shouldn't there be a mechanism to submit a proposed edit that gets reviewed and approved or denied, just like there is in the SO questions and answers section?
EDIT
I just found the edit controls in documentation. They are different than those for the SO question and answer section (and small and subtle controls) so i guess my suggestion is to either make the editing controls the same as those for SO questions and answers, change the editing controls for SO questions and answers, or create a meta documentation ReadMe that explains the differences.