It’s an excellent and amazing piece of work…except one crucial point, it’s no longer a document.

That works sometimes, and for some project, but most of the time, its just bad form for something that is intrinsically declarative.

The challenge with Ajax is keeping it document-centric, resource-centric, and declarative. But realistically, it just takes a little more thought, a little less jumping to the nearest programming language. Most of all, staying declarative requires a consistent effort to think about "what am I really trying to do", and a commitment to discover the "truisms" in the given purpose. It’s an abstract point, and one that’s hard to illustrate in a few paragraphs. But when you’re developing a library or framework, dealing with the abstract and meta is what you (are supposed to) do.

And now that all sounded ivory tower. But I swear, software architecture, library and framework developer really is an existentialistic exercise ;-)