Comment by chanux

I had diataxis in mind when I wrote my comment. It's an important and excellent guideline on picking the style based on purpose of the doc.