aboutsummaryrefslogtreecommitdiff
path: root/CONTRIBUTING.md
diff options
context:
space:
mode:
authorMark Otto <[email protected]>2013-12-18 10:22:18 -0800
committerMark Otto <[email protected]>2013-12-18 10:22:18 -0800
commit1bc8607bdffe641d58191084b214138a98aba229 (patch)
treeffb2855b592ee37c5068da181a4c3fb335a322da /CONTRIBUTING.md
parent9e38e255343a4fd5fa2fa932c96be9cb5c902337 (diff)
parentd15218a09ce68d0854d0aa5f5170c1ea859aee31 (diff)
downloadbootstrap-1bc8607bdffe641d58191084b214138a98aba229.tar.xz
bootstrap-1bc8607bdffe641d58191084b214138a98aba229.zip
Merge branch 'master' into css-source-maps
Conflicts: Gruntfile.js
Diffstat (limited to 'CONTRIBUTING.md')
-rw-r--r--CONTRIBUTING.md5
1 files changed, 4 insertions, 1 deletions
diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
index 708ace7ec..21062d9f1 100644
--- a/CONTRIBUTING.md
+++ b/CONTRIBUTING.md
@@ -37,12 +37,15 @@ We only accept issues that are bug reports or feature requests. Bugs must be iso
### CSS
-- Adhere to the [RECESS CSS property order](http://markdotto.com/2011/11/29/css-property-order/)
+- Adhere to the [CSS property order](http://markdotto.com/2011/11/29/css-property-order/)
- Multiple-line approach (one property and value per line)
- Always a space after a property's colon (e.g., `display: block;` and not `display:block;`)
- End all lines with a semi-colon
- For multiple, comma-separated selectors, place each selector on its 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).
+- Attribute selectors should only be used where absolutely necessary (e.g., form controls) and should be avoided on custom components for performance and explicitness.
+- Series of classes for a component should include a base class (e.g., `.component`) and use the base class as a prefix for modifier and sub-components (e.g., `.component-lg`).
+- Avoid inheritance and over nesting—use single, explicit classes whenever possible.
### JS