Documentation is a big pain point for many of the big platforms for me. Be it Android or iOS. On the Android side it seems like there was a huge push for docum

Documentation is a big pain point for many of the big platforms for me. Be it Android or iOS. On the Android side it seems like there was a huge push for documentation some years ago but due to the sheer size and scope it seems like many things just never got updated and new things got the "Gotta go Fast" treatment. It's always very frustrating reading an official "How-to" article telling you to do one thing and when you click through to the underlying system's documentation you notice that this is no longer how you do it. On the iOS side I can't understand how anyone figures out how things work. Maybe veterans know enough to decipher 4 word descriptions of a function argument and a random list of exposed function names but I certainly can't. e.g. How anyone figured out how ReplayKit works from the "docs" is beyond me. There is a WWDC video and hopefully some sample code you find in some repos but good luck with that... I can forgive a lot of peculiarities of a system if I can at least figure out the what & how in the documentation/guides. There are documentations for rather complex systems that I thought were absolutely amazing, e.g. the MS Hololens. So it is at least possible.