Commit Graph
463 Commits
Author SHA1 Message Date
Google Python team 4a6e97d092 Project import generated by Copybara.
PiperOrigin-RevId: 450985691
2022-05-25 14:03:28 -07: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
Titus Winters cada798ffe Merge pull request #688 from zetafunction/update-styleguide
Update C++ style guide.
2022-05-05 13:26:55 -04: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
Daniel Cheng 93c7bd88c6 Update C++ style guide.
- Reword guidance for definitions of inline functions and templates.
- Capitalize the first letter of various comments.
- Update command-line flag reference to use absl flags.
- Improve braced-initialization example for 64-bit constants.
- Delete C++03 guidance for NULL.
- Clarify wording around wrapping of string literals.
- Use C++17 [[fallthrough]] instead of ABSL_FALLTHROUGH.
2022-05-03 23:57:01 +00:00
Google Python team 2eb7e16647 Project import generated by Copybara.
PiperOrigin-RevId: 442743475
2022-04-25 20:17:14 +00:00
Gregory P. Smith 629edc1ca9 Merge pull request #683 from google/python_styleguide
Project import generated by Copybara.  Mostly modernizing to a 3.9+ Pythonisms. Some clarification on TypeVars.
2022-04-12 20:47:33 -07:00
Google Python team d2ca0a820a Project import generated by Copybara.
PiperOrigin-RevId: 440926376
2022-04-13 03:44:05 +00:00
Samuel Freilich af78b49ac4 Merge pull request #673 from rex4539/typos
Fix typos
2022-02-10 11:59:19 -05:00
Dimitris Apostolou 18fff725af Fix typos 2022-02-10 17:44:21 +02:00
Michael Diamond 31c830a22d Merge pull request #671 from cushon/gh-pages
Update Java style guide
2022-02-02 20:26:54 -08:00
Liam Miller-Cushon 89416627bc Move a </p> around 2022-02-02 20:00:05 -08:00
Liam Miller-Cushon 49488412b2 Update Java style guide 2022-02-02 19:31:16 -08: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 4f848da9f3 Merge pull request #667 from tonyruscoe/gh-pages
Update format for numbered sections and whitespace
2022-01-12 16:59:40 +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 106edd4b39 Merge pull request #666 from tonyruscoe/gh-pages
Remove prettyprint from HTML/CSS Style Guide
2022-01-12 13:59:46 +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
Gregory P. Smith 842b872ac4 Merge pull request #660 from google/python_styleguide
Project import generated by Copybara.
2021-12-07 13:42:38 -08:00
Google Python team 6e7639af59 Project import generated by Copybara.
PiperOrigin-RevId: 414768544
2021-12-07 21:40:47 +00:00
Titus Winters 9806df89a3 Merge pull request #650 from zetafunction/new-thingie
Update the C++ style guide.
2021-10-20 12:26:38 -04:00
Daniel Cheng 840e5839f6 Update the C++ style guide.
- Recommend the use of absl::implicit_cast for safe upcasting.
- Remove std::hash guidance
- Remove end-of-line comment guidance
- Remove "consistency to local style" guidance
- Miscellaneous wording updates
2021-10-20 09:17:56 -07:00
Google Python team 9a6a5d3db3 Project import generated by Copybara.
PiperOrigin-RevId: 396282811
2021-09-13 21:38:04 +00:00
Google Python team d88a5b7b59 Project import generated by Copybara.
PiperOrigin-RevId: 385825978
2021-07-20 11:05:01 -07:00
Titus Winters 78f4fca97f Merge pull request #643 from jruderman/patch-1
cppguide: remove space before comma
2021-07-20 12:08:07 -04:00
Jesse Ruderman b1956b20a2 cppguide: remove space before comma 2021-07-20 08:53:06 -07:00
Google Python team 4044bbd5ca Project import generated by Copybara.
PiperOrigin-RevId: 384778037
2021-07-14 14:12:11 -07:00
Google Python team 9c8784ded3 Project import generated by Copybara.
PiperOrigin-RevId: 372845522
2021-05-10 17:22:02 -07:00
Google Python team f614c922a8 Project import generated by Copybara.
PiperOrigin-RevId: 372441803
2021-05-07 19:58:49 -07:00
Titus Winters 15fddd2eaf Merge pull request #635 from elharo/code
add code of conduct
2021-04-26 07:11:07 -04:00
Elliotte Rusty Harold 0ce82b9a74 use the 2.0 version of the Contributor Covenant, with modification 2021-04-19 15:28:07 -04:00
Titus Winters bc0aa941db Merge pull request #636 from elharo/issue
add issue template discouraging contributions
2021-04-12 09:50:41 -04:00
Elliotte Rusty Harold 7ae99d6db0 add issue template 2021-04-12 08:53:25 -04:00
Elliotte Rusty Harold 6fc1f800ce add code of conduct 2021-04-12 08:35:57 -04:00
Titus Winters 68dc41b578 Merge pull request #634 from elharo/gh-pages
add pull request template discouraging contributions
2021-04-12 08:08:49 -04:00
Elliotte Rusty Harold aa19fd7504 allow for typo corrections 2021-04-09 08:21:46 -04:00
Elliotte Rusty Harold 103ea74d5d add pull request template discouraging contributions 2021-04-08 17:23:10 -04:00
Elliotte Rusty Harold f854eb0f9c Merge pull request #1 from google/gh-pages
merge head
2021-04-08 21:13:16 +00:00
Titus Winters 845e4f9a15 Merge pull request #633 from elharo/patch-1
docs: discourage external contributors
2021-04-08 17:04:38 -04:00
Elliotte Rusty Harold d754e413ec Update README.md 2021-04-08 20:30:44 +00:00
Elliotte Rusty Harold c6d79d07ab expand on treatment of external contributions 2021-04-08 20:28:33 +00:00
Elliotte Rusty Harold 52483ac7e4 docs: discourage external contributors
@tituswinters
2021-04-08 14:08:23 -04:00
Titus Winters 635fe96f8e Merge pull request #630 from zetafunction/gh-pages
Update C++ style guide.
2021-03-29 07:41:18 -04:00
Daniel Cheng 4e25657924 Update C++ style guide.
Mostly minor wording updates (e.g. preferring int64_t to int64). The
most significant change is clarifying the section on consistency to
clarify that consistency, in and of itself, should not be used as the
sole argument for blocking adoption of style changes.
2021-03-26 16:54:25 -07:00
Titus Winters 6e239d7f90 Merge pull request #620 from zetafunction/update-c++
Update C++ style guide.
2021-01-29 14:10:19 -05:00