Re:What nobody tells you about documentation
by stephenfin on Thursday December 07, 2017 @04:17PM
(#15874334)
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/
[2] http://docs.openvswitch.org/