I'm just dabbling a little with Swift and as a beginner I'm not qualified to be critical. However, this is Apple's documentation as seen on an iPhone: The verbose nature of the code presented means that it often won't fit onto the screen. I can reduce the font size, but then it's too small for me to read easily. This is from Apple's online docs: At least its wrapping around this time, but it's a bit of a mess. (That's using the default font size in Safari. I haven't increased it.) It's not helping that they've chosen to use names like "someFunction" etc. They could have used 'f' or 'foo'.