Check out How to design API documentation for opportunistic (active, experiential) learning styles by . Here is an excerpt:
A recent study looked at how developers interact with API documentation. It found a mix of systematic and opportunistic learning styles. While we often write with the former in mind, focusing on the latter styles (opportunistic) might be more beneficial, and will cause us to focus on improving…
The full article is available here.