javascript-coding-standards.markdown

@@ -14,6 +14,31 @@
 
 This is a set of coding conventions and rules for use in JavaScript programming. It is inspired by the [Sun](http://www.sun.com/) document [Code Conventions for the Java Programming Language](http://java.sun.com/docs/codeconv/). It is heavily modified of course because [JavaScript is not Java](http://javascript.crockford.com/javascript.html).
 
+The long-term value of software to an organization is in direct proportion to the quality of the codebase. Over its lifetime, a program will be handled by many pairs of hands and eyes. If a program is able to clearly communicate its structure and characteristics, it is less likely that it will break when modified in the never-too-distant future.
+
+Code conventions can help in reducing the brittleness of programs.
+
+All of our JavaScript code is sent directly to the public. It should always be of publication quality.
+
+Neatness counts.
+
+
+#### JavaScript Files
+
+JavaScript programs should be stored in and delivered as `.js` files.
+
+JavaScript code should not be embedded in HTML files unless the code is specific to a single session. Code in HTML adds significantly to pageweight with no opportunity for mitigation by caching and compression.
+
+`<script src=filename.js>` tags should be placed as late in the body as possible. This reduces the effects of delays imposed by script loading on other page components. There is no need to use the `language` or `type` attributes. It is the server, not the script tag, that determines the MIME type.
+
+
+
+
+
+
+
+
+
 
 #### References