Google style guide

You can find the Google style guide online at the following URL:

https://developers.google.com/style/

The Google style guide is a comprehensive resource for writers and editors working on Google products and communications. It provides guidelines and best practices for writing, editing, and formatting documents and other materials for a wide range of audiences and purposes.

The Google style guide covers a wide range of topics, including grammar, punctuation, capitalization, spelling, tone, and style. It also includes guidelines for formatting documents, using visuals and multimedia, and writing for the web.

One of the key features of the Google style guide is its emphasis on simplicity and usability. It encourages writers to use clear and concise language, avoid jargon and technical terms where possible, and focus on the needs and interests of their readers.

Overall, the Google style guide is an essential resource for writers and editors working on Google-related projects, and is designed to help ensure that Google's communications are clear, consistent, and effective.

Highlights

The style guide covers a lot of material, so the following page provides an overview of its most important points. For more information about topics on the page, follow the links.

Tone and content

• Be conversational and friendly without being frivolous.
• Don't pre-announce anything in documentation.
• Use descriptive link text.
• Write accessibly.
• Write for a global audience.

Language and grammar

• Use second person: "you" rather than "we."
• Use active voice: make clear who's performing the action.
• Use standard American spelling and punctuation.
• Put conditional clauses before instructions, not after.
• For usage and spelling of specific words, see the word list.

Formatting, punctuation, and organization

• Use sentence case for document titles and section headings.
• Use numbered lists for sequences.
• Use bulleted lists for most other lists.
• Use description lists for pairs of related pieces of data.
• Use serial commas.
• Put code-related text in code font.
• Put UI elements in bold.
• Use unambiguous date formatting.

Images

• Use SVG files or crushed PNG images.
• Provide alt text.
• Provide high-resolution images when practical.