@davidbisset this drives me *nuts* in documentation because it assumes a level of knowledge on par with the person who wrote the docs, which is rarely the case.

What I love when I read docs is absence of justs and simplies, but instead something like "this doc assumes that you have some x knowledge and if you don't you may want to start at (link to x knowledge)"

I try to do same when writing docs myself.