The reference docs for Java Standard Edition APIs and MSDN Win32 APIs were clear, comprehensive, and unambiguous. The behaviors of those platforms were also pre

The reference docs for Java Standard Edition APIs and MSDN Win32 APIs were clear, comprehensive, and unambiguous. The behaviors of those platforms were also predictable and deterministic. At a time when the internet was a luxury and there weren't Google and SO, I was able to learn and use Win32 APIs just from their reference docs and guides. In sharp contrast to Java's docs are Android's terrible docs. As a Java programmer, I had assumed Android's docs and behavior would be of equally high quality. But time and again, Android's platform had a a way of springing surprises that weren't documented anywhere. More than a decade has passed but the activity lifecycle's behavior and docs remain as ambiguous today in 2022 as they were in 2010!