Thank you for writing a tutorial - saltstack needs one and it will save people a lot of pain.<p>I don&#x27;t know of any good tutorials or tutorial theory. However, someone once showed me a trick that works well when describing something complicated:<p>Start writing at the end. The end of the text should be the first thing you write.<p>E.g describe the final setup and then fill in all the missing information that is needed to understand the goal.<p>This makes what you write much more focused.<p>Another thing that works well is that the text starts by describing a problem. This makes what follows more interesting.