diff --git a/conductor/code_styleguides/html-css.md b/conductor/code_styleguides/html-css.md new file mode 100644 index 0000000..74a0932 --- /dev/null +++ b/conductor/code_styleguides/html-css.md @@ -0,0 +1,49 @@ +# Google HTML/CSS Style Guide Summary + +This document summarizes key rules and best practices from the Google HTML/CSS Style Guide. + +## 1. General Rules +- **Protocol:** Use HTTPS for all embedded resources. +- **Indentation:** Indent by 2 spaces. Do not use tabs. +- **Capitalization:** Use only lowercase for all code (element names, attributes, selectors, properties). +- **Trailing Whitespace:** Remove all trailing whitespace. +- **Encoding:** Use UTF-8 (without a BOM). Specify `` in HTML. + +## 2. HTML Style Rules +- **Document Type:** Use ``. +- **HTML Validity:** Use valid HTML. +- **Semantics:** Use HTML elements according to their intended purpose (e.g., use `

` for paragraphs, not for spacing). +- **Multimedia Fallback:** Provide `alt` text for images and transcripts/captions for audio/video. +- **Separation of Concerns:** Strictly separate structure (HTML), presentation (CSS), and behavior (JavaScript). Link to CSS and JS from external files. +- **`type` Attributes:** Omit `type` attributes for stylesheets (``) and scripts (`