Recent Commits to styleguide:gh-pages

  • 03/06/2026 12:51

    Update C++ style guide

    Update C++ style guide
    
    One small update to clarify that omitting braces on control blocks is
    permitted but discouraged.
  • 01/05/2026 19:51

    Update C++ style guide (#971)

    Update C++ style guide (#971)
    
    - Ban forward declaration of entities not owned by the project.
    - Recommend `absl::down_cast` for downcasting instead of `static_cast`.
    - Expanded and reworked guidance on `auto` for variables and function
      parameters: in particular, encourage structured bindings for map-like
      containers.
    - Remove Boost section and add a section for third-party libraries with
      general guidance.
    - Other minor updates and improvements to wording, et cetera.
  • 09/04/2026 13:35

    2026 updates to the Java Style Guide. (#968)

    2026 updates to the Java Style Guide. (#968)
    Tags:
  • 18/03/2026 11:56

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

    go: Export the latest version of the internal guide. (#965)
    
    The update revises guidance around line length, import renaming, context
    usage, sentinel placement, and interface usage.
  • 13/11/2025 14:00

    Update C++ style guide (#949)

    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
  • 20/10/2025 7:39

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

    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.
  • 03/09/2025 13:29

    Update Java Style Guide following discussions.

    Update Java Style Guide following discussions.
    
    The edits here are the result of discussions with Kevin Bourrillion, the
    original author of much of this guide.
    Tags:
  • 31/07/2025 19:16

    Update C++ style guide (#937)

    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
  • 25/04/2025 18:47

    java: update to latest

    java: update to latest
    
    Pull in changes:
    * Update the Style Guide to talk about text blocks.
    * Added External TODO style section in Java style guide.
    * Update camel-case to explain how to separate adjacent numeric words.
    * Adjust indentation of `// fall through` comments
    * Remove forward looking promises about the formatter
    * Updates to account for inline @return Javadoc tag.
    * Integrate JAKE Java 21 Documentation branch into mainline.
    * Remove exception from '6.2 Caught exceptions: not ignored' for tests
    * Add style guidance for `package-info.java` and `module-info.java` files.
    * Correct possibly confusing indentation of an ellipsis.
    
    PiperOrigin-RevId: 751565114
    Tags:
  • 06/11/2024 7:53

    Update the HTML Document Type guidance (#862)

    Update the HTML Document Type guidance (#862)
    
    This update explicitly declares quirks mode to be against the style guide and strengthens the recommendation from “preferred” to “mandatory”. It also updates examples to use lowercase for consistency and clarifies that the style guide applies to Sass.
    Tags:
  • 05/09/2024 17:32

    Update C++ style guide (#835)

    Update C++ style guide (#835)
    
    - Explicitly ban `long double`
    - Use absl formatting libraries or `std::ostream` over printf-style
      functions.
    - Portability: use serialization libraries instead of copying the
      in-memory representation.
    - Update guidance to use `uintptr_t` (previously `intptr_t`) when
      working with pointers as integers.
    - Ban C++20 modules.
    - Ban coroutines (though this is expected to be temporary).
    - Minor wording updates.
    Tags:
  • 11/11/2020 3:26

    Update Google C++ styleguide

    Update Google C++ styleguide
    
    - Guidance for return values (prefer return by value, return by
      reference, then return by pointer in that order)
    - Mandate curly braces around the body of a control statement,
      providing one exception for historical reasons (`if` with no `else`,
      and `if` + body fits completely in a single line or the `if` fits in
      one line and the body fits in another separate line).
    Tags:
  • 16/09/2020 6:20

    Add owners for the Java and Shell guides, and alphabetize the list.

    Add owners for the Java and Shell guides, and alphabetize the list.
    Tags:
  • 28/07/2020 22:21

    Update language to comply with Android's inclusive language guidance

    Update language to comply with Android's inclusive language guidance
    
    See https://source.android.com/setup/contribute/respectful-code for
    reference
    
    cpplint.py is copied into AOSP from this github version so update it
    here first.
    
    Bug: 161896447
    Test: None (comments only)
    Tags:

Log in