On 09/30/2017 02:15 PM, Brandon Allbery wrote:
This concept gets reused enough that it's not separately described for every place where it is used; the documentation would be impossible to manage, almost as impossible to read, and often out of sync with itself if every reused concept had to be fully explained everywhere it is used.
In this lies the problem I have with a lot of documentation. It is often written as a refresher for those who already familiar with the concepts. Linux "man pages" are notorious for this. A compromise would be to start simple and then proceed into the complex. Technical writing such as this is truly an art form.
