All jolly good points -- and I think this document should fall into the latter category (assuming high level of knowledge, requiring gloss). Though I'd have to look more closely before committing myself to that opinion.

A lot of the tensions in the world of web seem to boil down to the fact that everybody uses the web, and a lot of the people who use it know a little about it (and as we know, a little knowledge is a dangerous thing). It's such an interdisciplinary (bzz!) field that you're invariably going to have lots of people with different backgrounds, expectations, priorities, and languages -- and all too often people don't realise the extent of what they don't know.

Documentation can bridge those gaps, but how often does it actually just introduce another layer of misunderstanding, trying to be all things to everyone and ending up being nothing to anyone?

This post brought to you by the mood 'cynical'. (Tomorrow's scheduled to be a 'positive' day, so I might feel better about it then. You have to alternate, otherwise you either become an evangelist for things that don't work or you sink into the Slough of Despond.)