To me documentations are different from SO questions they should first address the most applicable scenario and then from there answer questions that are less common. If they answer corner cases then they are no different from SO questions itself. Right now this question highest voted example is a tangential one.
I completely know what AutoLayout is and while this example is extremely useful I think it deviates the SO's documentation vision. It doesn't touch the most common needs, it's positioning as the highest voted answer creates confusion for people who is see this as an answer to 'what is AutoLayout`.
The 2nd and 3rd answers are much more generic. So my question is: Is this the right direction of Documentations, or should I flag the example for anything or edit the example to 'this is not a common use case but'.