Documentation is where I go to find out the mental model behind the software.
“Show me your flowcharts and conceal your tables, and I shall continue to be mystified. Show me your tables, and I won’t usually need your flowcharts; they’ll be obvious.”
— Fred Brooks
With the mental model of the software, I know where to go, where to look, how to change to fulfil my new requirements.
I am thinking of writing a fictional documentation for a fictional operating system or library or web framework and then see where that design takes me.
“Show me your flowcharts and conceal your tables, and I shall continue to be mystified. Show me your tables, and I won’t usually need your flowcharts; they’ll be obvious.”
— Fred Brooks
With the mental model of the software, I know where to go, where to look, how to change to fulfil my new requirements.
I am thinking of writing a fictional documentation for a fictional operating system or library or web framework and then see where that design takes me.