Style Guide

Mostly just notes to myself.

Naming Conventions

generally:

• anObject-child--state (example: card-title--broken;)
• mixins: .bordered; .hidden; .link--hidden;

LESS Files

• style: master stylesheet, sets some variables and imports the crap out of the other stylesheets
• basic: applies basic typography and colours
• mixins: for mixins, can also be used in the templates for convenience
• objects: generalised classes that are extended where needed (like cards or lists)
• layout: takes care of providing a basic layout for the page, think content blocks, not single lines
• main: the core stylesheet
• pages: handles styles for specific pages on the site

From elsewhere

• normalize, what it says on the tin
• font_awesome, does all the heavy heavy lifting for the icon webfont

Indentation conventions

• Always indent after headings for better folding
• Indent after opening parentheses, the closing ones are on the same level as the line opening them

Attribute conventions

(mixins), display, float status, width, height, margin, border, padding, everything else

Nesting

Don't nest if not necessary, use classes that are unique enough.