Why is the Documentation full of Conundrums?

I'm trying to learn and focus on the task and your examples keep having hidden conundrums in them.

Here is an example that got me snagged for hours last night going, Well what the F do they want me to name it?

What is it you want me to learn here? Because you pose a giant riddle of name something that you should be given a name for...

My friend said to me that this is a common thing you will have to do and they were right however...

What are you asking me to do? Get stuck on the variable naming problem where I'm going... Yeah those are math terms from 20+ years ago and I have no idea how to classify those terms...

Are you asking me that? No. So why is that in the problem.

These conundrums mixed in with legitimate problems honestly make me not want to learn Swift at all.

Why is the Documentation full of Conundrums?
 
 
Q