This is very similar to the advice of Jacob-Kaplan Moss, architect of the Django documentation [1]. I used this very advice in the authoring of the Open vSwitch

This is very similar to the advice of Jacob-Kaplan Moss, architect of the Django documentation [1]. I used this very advice in the authoring of the Open vSwitch documentation [2] though I, like other commenters here, did have difficulty distinguishing between tutorials and how-tos. [1] https://jacobian.org/writing/what-to-write/ https://jacobian.org/writing/what-to-write/ [2] http://docs.openvswitch.org/ http://docs.openvswitch.org/