John,
That was well stated, and I could not agree more. The documents are intended to be understandable to the users, not the technical people producing them. Whatever the approach, it must be consistent across all of the documents while being clear ...