Daniel Cheng
78c5bdd851
Update C++ style guide.
...
- Include friend types in class declaration order guidance.
- Include previously omitted text (due to mismatched tags) about
preferring int16_t over short, et cetera.
- Function declarations:
- Updated guidance for what comments should cover.
- Add a C++ attribute example.
2022-07-05 22:28:56 +00:00
Google Python team
25bd3525fa
Project import generated by Copybara.
...
PiperOrigin-RevId: 453566611
2022-06-07 17:56:13 -07:00
Gregory P. Smith
965d902e13
Merge pull request #697 from google/python_styleguide
...
Project import generated by Copybara.
2022-06-07 17:09:21 -07:00
Google Python team
c2b992c6f5
Project import generated by Copybara.
...
PiperOrigin-RevId: 453553841
2022-06-07 17:08:25 -07:00
Gregory P. Smith
a5197abff2
Merge pull request #692 from google/python_styleguide
...
Project import generated by Copybara.
2022-05-25 14:05:50 -07:00
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