Commit Graph

22 Commits

Author SHA1 Message Date
Tony Ruscoe 2173b8d68c Update the HTML Document Type guidance
This removes the guidance around not closing void elements since this is incompatible with the Prettier formatter.
2023-04-26 12:22:36 +01:00
Tony Ruscoe 453aca8c43 Update the HTML Line-Wrapping guidance
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.
2023-04-24 14:42:52 +01:00
Tony Ruscoe 1faa779a12 Make the Declaration Order recommendation optional
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.
2022-05-06 11:48:31 +01:00
Tony Ruscoe 992ad03d50 Update HTML Line-Wrapping examples
Replaces the examples in the HTML Line-Wrapping recommendation to include child elements.
2022-05-05 10:04:58 +01:00
Tony Ruscoe e6233c7428 Add recommendation to avoid using !important
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.
2022-01-13 14:29:39 +00:00
Tony Ruscoe 8d4a22bd69 Update ID and class selector/attribute guidance
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.
2022-01-13 14:13:57 +00:00
Tony Ruscoe 5ac8b604fa Move the ID and Class Name sections to be together
This change was made to the internal style guide a while ago to make it easier to find related sections also containing IDs and class name guidance.
2022-01-13 14:03:19 +00:00
Tony Ruscoe 2dcaf50252 Prefer leading zeros in CSS values
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.
2022-01-13 13:53:15 +00:00
Tony Ruscoe 50c42bf956 Explain the 4-space HTML line-wrapping guidance
This clarification was added to the internal style guide a few months ago.
2022-01-13 13:46:52 +00:00
Tony Ruscoe aec4ccfe4b Update format for numbered sections and whitespace 2022-01-12 16:56:30 +00:00
Tony Ruscoe 18ed71c507 Replace HTML entities in the HTML/CSS Style Guide
The internal script that converts our style guides from Markdown to HTML now does this.
2022-01-12 14:33:52 +00:00
Tony Ruscoe 53c4d95517 Remove prettyprint from HTML/CSS Style Guide
This is because the internal style guide does not use prettyprint.
2022-01-12 13:47:57 +00:00
Tony Ruscoe 9c6b371f41 Increase indentation for type attribute examples
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.
2019-04-23 08:48:28 +01:00
Christian Oliff 19835af7b1 update jQuery version in example
I know it's only an example, but best to have the most recent version here which doesn't have a known security vulneability.
2019-04-17 16:59:48 +09:00
Eric Clinger 967ca824e3 Removed RAS (redundant acronym syndrome) syndrome
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.
2019-02-21 18:32:43 -07:00
Ted Osborne 505ba68c74 Revert "Project import generated by Copybara."
This reverts commit 54cca78d64.
2018-01-30 12:36:50 -05:00
Google Python team 54cca78d64 Project import generated by Copybara.
PiperOrigin-RevId: 179577576
2018-01-30 12:10:03 -05:00
Tony Ruscoe dc39c82233 Update HTML/CSS style guide
* Add an optional line-wrapping recommendation.
* Update links to the WHATWG HTML spec which were redirecting.
* Minor content and markup edits.
2017-11-15 11:50:33 +00:00
Matthew Paul Gross 4b9f3fbe28 Removing empty <pre> tags 2017-11-14 13:12:02 -05:00
Tony Ruscoe ad6dee81e9 Fix HTML validation warnings and make the style guide HTML more compliant. 2017-02-27 08:16:24 +00:00
Tony Ruscoe a1773f9b3b Add an anchor for the “Parting Words” section and change the emphasis on “Be consistent.” 2017-02-24 14:38:42 +00:00
Tony Ruscoe d0960a41c0 Move, update, and convert HTML/CSS Style Guide from XML to HTML. (#232) 2017-02-24 12:31:41 +00:00