This is the GH avatar and is slightly different from the icon used on
other Google properties. This makes it easier to distinguish in a big
tab strip.
Fixes: #489
This update explicitly declares quirks mode to be against the style guide and strengthens the recommendation from “preferred” to “mandatory”. It also updates examples to use lowercase for consistency and clarifies that the style guide applies to Sass.
This relaxes the guidance around indenting by 4 additional spaces and provides the Prettier format as one of the examples to ensure the style guide is compatible with the Prettier formatter.
This recommendation was relaxed in the internal style guide a few months ago. The suggestion is still to continue using alphabetical order unless teams have access to the appropriate tooling which can support consistently automating and enforcing different sorting rules which may be more logical to read.
This recommendation was adopted internally to align with our infrastructure conformance checks and best practices.
While !important is a legitimate feature of CSS, its use increased complexity and maintenance costs when styles were reused and shared across multiple projects.
We now recommend avoiding unnecessary `id` attributes and prefer using class selectors for styling.
Where `id` attributes are strictly required, we recommend always including a hyphen in the value.
This was reversed in the internal style guide a while ago to align the guidance with our autoformatting tooling configuration.
Any optimisations to reduce file size should be handled by compilers and minifiers.
The HTML Line-wrapping recommendation is to use four additional spaces when wrapping HTML, yet the “Not recommended” examples for the `type` attribute rule were using two spaces.
References to HTTPS and HTTP were written as HTTPS protocol (Hypertext Transfer Protocol Secure protocol) and HTTP protocol (Hypertext Transfer Protocol protocol) which is redundant.
Mike Frysinger