...Writing documentation is an exercise in empathy. We're not describing an objective reality - the source code already does that. Our job is to help shape the relationship between users and the Vue ecosystem. This ever-evolving guide provides some rules and recommendations on how to do that consistently within the Vue ecosystem. Principles A feature … Continue reading Documentation As Empathy
Tag: documentation
Lab Notebooks
"* Always in penYour goal is not to preserve the outcome of your thoughts — that’s your code. Your goal is to preserve the process of your thoughts. So no erasing, no blacking out. You can put a single line through anything spelled or written incorrectly.* Always during Write down what the problem is, what … Continue reading Lab Notebooks
A Theory of Documentation
"Documentation needs to include and be structured around its four different functions: tutorials, how-to guides, explanation and technical reference. Each of them requires a distinct mode of writing. People working with software need these four different kinds of documentation at different times, in different circumstances - so software usually needs them all. And documentation needs … Continue reading A Theory of Documentation
cafebedouin.org 