There’s a new entry on Clearleft’s blog about front-end design principles. Jeremy wrote about the process, too. Some of their decisions are based on, not their own preferences as individuals or as a company, but those of the people who will have to work with the code after they are done.
“When it comes to coding style, we have our own preferences but those will take a back seat to the preferences of any developers who will be working with our code after we our work is done. Likewise, we might have our own preferences for libraries or preprocessors (if they are used at all) but our preferences are secondary to those of the developers taking delivery of our code.”
There’s also this bit about documentation, which I think makes sense:
“The code will be suitably commented, and in-code comments will be favoured over documentation.”