Hacker News new | ask | show | jobs
by afarrell 2338 days ago
> I need to see practical examples

And I need to see diagrams of mental models, though practical examples help solidify that. So one challenge with writing documentation is knowing what your audience needs. A better taxonomy of documentation would help solve this. For now, here is one I like based on https://www.divio.com/blog/documentation/

- Tutorial: A walk through how to learn the basics as you build something.

- Explanation: Showing the mental model of something

- Guide: A walk through how to solve a specific problem

- Reference: A comprehensive* listing of the API capabilities and how they are used.

-------

If anyone knows of some good tutorials or explanations of mobile programming with React, I'd be grateful for recommendations.