diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md index 463bfca781..43c7161802 100644 --- a/CONTRIBUTING.md +++ b/CONTRIBUTING.md @@ -23,12 +23,6 @@ We only accept issues that are bug reports or feature requests. Bugs must be iso -## Notes on the repo - -As of v2.0.0, Bootstrap's documentation is powered by Mustache templates and built via `make` before each commit and release. This was done to enable internationalization (translation) in a future release by uploading our strings to the [Twitter Translation Center](http://translate.twttr.com/). Any edits to the docs should be first done in the Mustache files and then recompiled into the HTML. - - - ## Pull requests - Try to submit pull requests against the latest `*-wip` branch for easier merging @@ -40,16 +34,16 @@ As of v2.0.0, Bootstrap's documentation is powered by Mustache templates and bui -## Coding standards: HTML +## Coding standards + +### HTML - Two spaces for indentation, never tabs - Double quotes only, never single quotes - Always use proper indentation - Use tags and elements appropriate for an HTML5 doctype (e.g., self-closing tags) - - -## Coding standards: CSS +### CSS - Adhere to the [Recess CSS property order](http://markdotto.com/2011/11/29/css-property-order/) - Multiple-line approach (one property and value per line) @@ -58,9 +52,7 @@ As of v2.0.0, Bootstrap's documentation is powered by Mustache templates and bui - For multiple, comma-separated selectors, place each selector on it's own line - Attribute selectors, like `input[type="text"]` should always wrap the attribute's value in double quotes, for consistency and safety (see this [blog post on unquoted attribute values](http://mathiasbynens.be/notes/unquoted-attribute-values) that can lead to XSS attacks). - - -## Coding standards: JS +### JS - No semicolons - Comma first