Recent Commits to styleguide:gh-pages

Update C++ style guide (#949)

- Clarify that TODO styles are listed in order of preference
- No space between type and `*` or `&`
- Minor wording updates for structs and move semantics
- Allow naming exceptions for Rust interop

go: Export the latest version of the internal guide. (#947)

The updates revise the import ordering and grouping guidance, adds
information to errors and wrapping and more clearly suggests to think
versus reflexively wrapping, makes clear that `%w` verb placement does
not encourage reflexively wrapping, more clearly differentiates the
`must` prefix, revises package naming, and applies other small instances
of copy editing.

Update C++ style guide (#937)

- Allow coroutine use via libraries approved by project leads
- Disallow using a space before `*` and `&` for pointer and reference
  types
- Simplify guidance for using vertical whitespace
- Other minor formatting / typography / wording fixes, e.g. adding
  goodcode/badcode annotations to examples

Add styling rules for good code examples in shared stylesheet

This change primarily affects the C++ style guide: while a number of
other style guides also use <pre> directly for code examples, the other
style guides all use JS to prettyprint the code blocks, and the
prettyprinter overrides the styles specified in the shared stylesheet.

The exception is the AngularJS style guide, but it is already
inconsistently formatted and this change does not make it any worse.

There are also several other style guides other than C++ where
good/neutral are rendered identically; this commit does not attempt to
address those either.

angularjs: fix init logic

The run_prettify.js link hasn't worked for years, so updae it to the
current cdn we use in other pages.

The styleguide.js link has always been broken.  Fixing that requires
tweaking how the TOC works.  We drop the static one in favor of the
dynamic (like other styleguides), and drop the custom <base> setting
so all links open in the current tab (like other styleguides).

update google/code-prettify load URL

The rawgit service was shutdown in 2019, and people are supposed to
migrate to cdn.jsdelivr.net.
https://groups.google.com/g/js-code-prettifier/c/IFHev_kLm30

jsoncstyleguide: sync from latest internal version

PiperOrigin-RevId: 751434392

Wrap the block comment asterisk in a code element

Update cppguide.html

NOTE: This site is deprecated. The site will be turned down after January 31, 2023, and traffic will redirect to the new site at https://protobuf.dev. In the meantime, updates will be made only to protobuf.dev.
https://developers.google.com/protocol-buffers/docs/reference/cpp-generated#package

markdown: Fix nerdy reference (#275)

jsguide: Replaced unfamiliar words with simpler alternatives. (#849)

Fixes #596.

go: Export the latest version of internal guide. (#915)

The updates enhance the existing guidance around package naming, utility
packages, import renaming, function call arguments that span many lines,
and the prohibition of assertion frameworks.

Update C++ style guide (#914)

- Expand guidance around usage of functions (and variables) with inline
  definitions.
- Change guidance around internal namespaces to reduce the likelihood of
  collisions.
- Expand naming guidance, with specific additional rules around:
  - nested namespaces not reusing well-known top-level names
  - template parameters
  - name aliases
- Clarify that constant-style naming also applies to static class
  constants.
- Other miscellaneous formatting and documentation improvements, e.g.
  additional Abseil TotW links.

go: Export the latest version of internal guide. (#912)

The updates encompass renaming testing-associated package's section
heading, guidance on when to panic, and naming of subtests.

Update CODEOWNERS (#894)

Remove self from OWNERS

Haven't been on the team that owns this style guide for several years.

go: Export the latest version of internal guide. (#888)

* go: Export the latest version of internal guide.

The updates encompass copy editing, enchanced guidance on package
sizing, fixing broken hyperlinks, simplifying Protocol Buffer message
guidance, clarifying context root behavior after (testing.TB).Context,
and disjoint table test.

CODEOWNERS: drop ex-Googlers

GitHub: Refresh Code Owners for Current Go Admins (#890)

The current Go Readability Approvers administration group has grown
over the last few years, so we should refresh the code owners to
make maintenance of the external style guide easier.  This also
lightens the geographic load for reviews, too.

And remove Kevin since his departure from the team.

Project import generated by Copybara.

PiperOrigin-RevId: 730435889

pylintrc: Project import generated by Copybara.

PiperOrigin-RevId: 729623959

Updated pylintrc with intended changes (#880)

Fixes #871.

LICENSE: switch to CC-BY-3.0 #637

We've always said the style guides are licensed under CC-By 3.0 in
our README file.  We use other licenses for code snippets, and list
those in the respective file headers, but the guides are the dominant
source in this repo, so list that in the LICENSE file.

Fixes #637.

pylintrc: add explicit Apache license for export #637

Most content in the external styleguide repo is Creative Commons based,
so add an explicit license to files that aren't to avoid confusion.

htmlcssguide: Update TODO format (#884)

This update changes the TODO formatting and examples to more closely align with Google’s internal TODO style.

pylintrc: disable score reports

We disable reports in general already, but newer pylint versions include
per-file score reports by default.

PiperOrigin-RevId: 725563567

add commit message guidance #336

Since many Google projects refer to this site for writing git commit
messages already, or have guidance that is well aligned with it, link
to them rather than write our own document.

Fixes: #336

set favicon #489

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

cpplint: declare bankruptcy

We have not pushed updates to the public cpplint code from our internal
version in years.  No one seems interested in picking it up either.

Since an open source community has formed & forked & updated it, let's
delete our ancient version and just send people to that project now.

objc: export latest version

PiperOrigin-RevId: 716659780

docguide: Fix a typo

objcguide: Fix a typo

shell: Project import generated by Copybara.

PiperOrigin-RevId: 716401731

json: add missing closing string quote (#867)