Comment by sosagain

>Either you are so vague that people muddle, then google and your book is effectively useless. Or you are so prescriptive that people end up reading a floor plan to build an OS and get squat out of it.

Finding a middle ground is of course key.