There are bugs and undocumented behaviors that need to be understood in order to be worked around - I wish it wasn't the case but such is life developing for closed-source platforms.

Sometimes things aren't documented and sometimes they could be documented wrong.