Merge pull request #49 from xuchenhan-tri/update-2022-6-23

Merge google upstream as of 2022-06-23

Author: jwnimmer-tri

.github/issue_template_ignored.md

@@ -0,0 +1,11 @@
+This repository publishes copies of Google's internal style guides to
+assist developers working on Google owned and originated open source
+projects. Development on these guides does not take place here.
+
+Substantive changes to the style rules and suggested new rules should
+not be submitted as issues in this repository. Material changes must be
+proposed, discussed, and approved on the internal forums first.
+
+If an issue points out a simple mistake — a typo, a broken link, etc. —
+then a correction might be made. However there is no commitment to do
+so. Issues are normally closed without comment. 

.github/pull_request_template_ignored.md

@@ -0,0 +1,13 @@
+These style guides are copies of Google's internal style guides to
+assist developers working on Google owned and originated open source
+projects. Changes should be made to the internal style guide first and
+only then copied here.
+
+Unsolicited pull requests will not be merged and are usually closed
+without comment. If a PR points out a simple mistake — a typo, a broken
+link, etc. — then the correction can be made internally and copied here
+through the usual process.
+
+Substantive changes to the style rules and suggested new rules should
+not be submitted as a PR in this repository. Material changes must be
+proposed, discussed, and approved on the internal forums first.

CODE_OF_CONDUCT.md

@@ -0,0 +1,74 @@
+# Contributor Covenant Code of Conduct
+
+## Our Pledge
+
+We as members, contributors, and leaders pledge to make participation in our
+community a harassment-free experience for everyone, regardless of age, body
+size, visible or invisible disability, ethnicity, sex characteristics, gender
+identity and expression, level of experience, education, socio-economic status,
+nationality, personal appearance, race, caste, color, religion, or sexual identity
+and orientation.
+
+We pledge to act and interact in ways that contribute to an open, welcoming,
+diverse, inclusive, and healthy community.
+
+## Our Standards
+
+Examples of behavior that contributes to a positive environment for our
+community include:
+
+* Demonstrating empathy and kindness toward other people
+* Being respectful of differing opinions, viewpoints, and experiences
+* Giving and gracefully accepting constructive feedback
+* Accepting responsibility and apologizing to those affected by our mistakes,
+  and learning from the experience
+* Focusing on what is best not just for us as individuals, but for the
+  overall community
+
+Examples of unacceptable behavior include:
+
+* The use of sexualized language or imagery, and sexual attention or
+  advances of any kind
+* Trolling, insulting or derogatory comments, and personal or political attacks
+* Public or private harassment
+* Publishing others' private information, such as a physical or email
+  address, without their explicit permission
+* Other conduct which could reasonably be considered inappropriate in a
+  professional setting
+
+## Enforcement Responsibilities
+
+Repo maintainers are responsible for clarifying and enforcing our standards of
+acceptable behavior and will take appropriate and fair corrective action in
+response to any behavior that they deem inappropriate, threatening, offensive,
+or harmful.
+
+Repo maintainers have the right and responsibility to remove, edit, or reject
+comments, commits, code, wiki edits, issues, and other contributions that are
+not aligned to this Code of Conduct, and will communicate reasons for moderation
+decisions when appropriate.
+
+## Scope
+
+This Code of Conduct applies within all community spaces, and also applies when
+an individual is officially representing the community in public spaces.
+Examples of representing our community include using an official e-mail address,
+posting via an official social media account, or acting as an appointed
+representative at an online or offline event.
+
+## Attribution
+
+This Code of Conduct is adapted from the [Contributor Covenant][homepage],
+version 2.0, available at
+[https://www.contributor-covenant.org/version/2/0/code_of_conduct.html][v2.0].
+
+Community Impact Guidelines were inspired by 
+[Mozilla's code of conduct enforcement ladder][Mozilla CoC].
+
+For answers to common questions about this code of conduct, see the FAQ at
+[https://www.contributor-covenant.org/faq][FAQ].
+
+[homepage]: https://www.contributor-covenant.org
+[v2.0]: https://www.contributor-covenant.org/version/2/0/code_of_conduct.html
+[Mozilla CoC]: https://github.com/mozilla/diversity
+[FAQ]: https://www.contributor-covenant.org/faq

README.md

@@ -164,11 +164,11 @@ style guidelines we use for Google code. If you are modifying a project that
 originated at Google, you may be pointed to this page to see the style guides
 that apply to that project.
 
-This project holds the [C++ Style Guide][cpp], [C# Style Guide][csharp], 
+This project holds the [C++ Style Guide][cpp], [C# Style Guide][csharp],
 [Swift Style Guide][swift], [Objective-C Style Guide][objc],
 [Java Style Guide][java], [Python Style Guide][py], [R Style Guide][r],
 [Shell Style Guide][sh], [HTML/CSS Style Guide][htmlcss],
-[JavaScript Style Guide][js], [AngularJS Style Guide][angular],
+[JavaScript Style Guide][js], [TypeScript Style Guide][ts], [AngularJS Style Guide][angular],
 [Common Lisp Style Guide][cl], and [Vimscript Style Guide][vim]. This project
 also contains [cpplint][cpplint], a tool to assist with style guide compliance,
 and [google-c-style.el][emacs], an Emacs settings file for Google style.
@@ -185,6 +185,19 @@ See [https://creativecommons.org/licenses/by/3.0/][ccl] for more details.
 The following Google style guides live outside of this project:
 [Go Code Review Comments][go] and [Effective Dart][dart].
 
+
+## Contributing
+
+With few exceptions, these style guides are copies of Google's internal style guides
+to assist developers working on Google owned and originated open source projects.
+Changes to the style guides are made to the internal style guides first and
+eventually copied into the versions found here. **External contributions are
+not accepted.** 
+Pull requests are regularly closed without comment.
+Issues that raise questions, justify changes on technical merits,
+or point out obvious mistakes may get some engagement and could in theory lead to changes,
+but we are primarily optimizing for Google's internal needs.
+
 <a rel="license" href="https://creativecommons.org/licenses/by/3.0/"><img alt="Creative Commons License" style="border-width:0" src="https://i.creativecommons.org/l/by/3.0/88x31.png" /></a>
 
 
@@ -198,6 +211,7 @@ The following Google style guides live outside of this project:
 [sh]: https://google.github.io/styleguide/shellguide.html
 [htmlcss]: https://google.github.io/styleguide/htmlcssguide.html
 [js]: https://google.github.io/styleguide/jsguide.html
+[ts]: https://google.github.io/styleguide/tsguide.html
 [angular]: https://google.github.io/styleguide/angularjs-google-style.html
 [cl]: https://google.github.io/styleguide/lispguide.xml
 [vim]: https://google.github.io/styleguide/vimscriptguide.xml