google/styleguide

Google Style Guides is a collection of style guides for multiple programming languages and formats used across Google-originated open-source projects.

The project addresses the problem of maintaining consistency across large codebases by documenting conventions for code style, naming, structure, and best practices. It covers ground ranging from naming conventions like camelCase to architectural decisions like avoiding global variables or exceptions. The guides are presented as reference documents that developers can consult when contributing to Google projects or when designing their own style standards.

Developers working on Google-originated open-source projects should use these guides as the authoritative reference for their contributions. The collection spans seventeen languages and formats including C++, Python, Java, Go, JavaScript, TypeScript, and others, making it useful for polyglot teams. The guides are also valuable as templates for organizations designing their own style standards, since they represent decisions made by experienced teams at scale. The project explicitly notes that external contributions are not accepted and that changes flow from Google's internal style guides outward, so these should be treated as read-only references rather than community-driven standards.

Development of the style guides is driven by Google's internal needs, with changes made to internal versions first before being copied into the public repository. The project does not actively solicit external pull requests, though issues that raise technical questions or point out mistakes may receive engagement. The guides themselves are stable reference documents rather than actively developed software, with updates reflecting shifts in Google's internal practices.