https://github.com/sencha/code-guidelines

Code Style Guidelines for JavaScript
https://github.com/sencha/code-guidelines

Last synced: about 4 hours ago
JSON representation

Code Style Guidelines for JavaScript

• Host: GitHub
• URL: https://github.com/sencha/code-guidelines
• Owner: sencha
• License: apache-2.0
• Created: 2014-10-23T16:56:00.000Z (about 10 years ago)
• Default Branch: master
• Last Pushed: 2018-09-13T23:30:31.000Z (about 6 years ago)
• Last Synced: 2023-11-07T20:11:35.856Z (about 1 year ago)
• Size: 68.4 KB
• Stars: 120
• Watchers: 30
• Forks: 28
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        


  

  



# Sencha's Guide to JavaScript Style and Best Practices


The following document contains a series of best practices and recommendations for building enterprise web applications 

with JavaScript and HTML5. 

Much of this advice is used internally at Sencha and certainly applies to building applications with the Sencha 

frameworks -- but this JavaScript style guide can also help teams building applications with any framework, or 

even just vanilla JavaScript.

## Mission Statement

Sencha firmly believes that high quality JavaScript is above all else consistent, and addresses four main pillars:

  - **Readability:** JavaScript code should be clear and easy to understand at first glance

  - **Maintainability:** JavaScript code should be consistent and cohesive

  - **Error Prevention:** JavaScript code should strategically avoid common problems

  - **Performance:** JavaScript code should always consider faster implementations

This style guide will attempt to provide some ground rules for building enterprise web applications with JavaScript and 

HTML5, and as such is intended primarily for medium-to-large development teams. 

These recommendations are based on our own experiences, as well as direct interaction with our enterprise customers.

## Dogma vs Doctrine

Avoid obsessing about code style -- this document is merely a guide, not infallible dogma. It is not intended to be a 

comprehensive list of all "best practices", but rather a list of the most common areas on which people ask our 

opinions. Many others have created [similar documents](Resources.md) and clearly not everyone agrees on every point. 

The overall goal for this document is to help you evaluate what we consider to be the important aspects of "quality" 

code, and ultimately create your own readable, maintainable and scalable JavaScript projects. Our suggestions stand as 

a baseline from which your teams should implement your own strategy for building a high quality JavaScript codebase. 

# Outline

To best articulate Sencha's experience building both frameworks and enterprise applications, we will divide this 

discussion into four parts:

  1. [Readability](Readable_JavaScript.md)

  2. [Maintainability](Maintainable_JavaScript.md)

  3. [Preventing Errors](Preventing_JavaScript_Errors.md)

  4. [Performance](JavaScript_Performance.md)

It is worth noting that many of the points we will cover might fit into more than one of these pillars.