Thank you for writing a tutorial - saltstack needs one and it will save people a lot of pain. I don't know of any good tutorials or tutorial theory. However, s

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