I would like to start a discussion around what would be a good style guide for 
a angular/SASS/bootstrap based GUI for metron.

A coding styleguide (note, not a visual styleguide) is a valuable tool for 
teams that strives for a degree of standardization in their code. A good 
styleguide, when well followed, will

-set the standard for code quality across a codebase;
-promote consistency across codebases;
-give developers a feeling of familiarity across codebases;
-increase productivity.

ANGULAR:
A lot of guidelines are already proposed by angular team in their docs which 
when followed creates a good consistent code base. You can check the angular2 
style guide here<https://angular.io/docs/ts/latest/guide/style-guide.html>. 
While the guide talks in length about anguar code(Javascript/Typescript)  it 
doesn't talk about standards for html and css and hence creating the need of 
this doc.

HTML & CSS:
There are many good style guides out there we can follow them as is or cherry 
pick the items as we like. I would propose that we follow these below two 
guides as is.

https://google.github.io/styleguide/htmlcssguide.xml
https://github.com/airbnb/css

You can look at more style guides at http://styleguides.io/

While these style guides talk about general HTML/CSS we can have few more 
guidelines around angular component templates and styles.
1.We can follow BEM naming conventions for all css files 
(https://css-tricks.com/bem-101/)
2. Keep the style of the component within the component, do not add it to the 
global styles
3. Prefer overwriting the styles instead of creating a new class.
Ex: if we have a global style as .btn{min-width:100px} and we want a button to 
have min-width of 200px in the component style you can overwrite it as 
.btn{min-width:200px} instead of defining new class like 
.btn-someother{min-width:200px} this will ensure that we can have a common 
place to add any new attributes to buttons in the future.
4.Add all the colors and any other variables that are used in theming of the 
appication to _variables.scss. This will help us to re-theme the application.
5.Use the bootstrap components and layouts as much as possible.


-Regards,
Raghu Mitra

Reply via email to