This page provides a summary of significant changes to the style guide.

## October 16, 2026

| New guidance or change | Page |
|---|---|
| Added generalized guidance about avoiding subjective language, including words like *simply*, *quickly*, *properly*, and *carefully*. | [Write inclusive documentation](https://developers.google.com/style/inclusive-documentation), [Write for a global audience](https://developers.google.com/style/translation), [Word list](https://developers.google.com/style/word-list) |
| Added guidance about limiting the use of participles and gerunds to improve clarity for a global audience. In particular, when *using* is ambiguous, consider *by using* or *that use*. | [Write for a global audience](https://developers.google.com/style/translation), [Word list](https://developers.google.com/style/word-list) |
| Simplified guidance against using *vice versa*, and added examples. | [Word list](https://developers.google.com/style/word-list) |

## July 7, 2026

| New guidance or change | Page |
|---|---|
| Softened a statement regarding the effect of inconsistent terminology on translation costs. | [Write for a global audience](https://developers.google.com/style/translation) |
| Added cross-references between guidance about optional procedure steps and guidance about optional headings. | [Headings and titles](https://developers.google.com/style/headings), [Procedures](https://developers.google.com/style/procedures) |
| Clarified that much of our guidance about writing inclusive documentation relates to the broader principle of avoiding figurative language, which can be ableist or unnecessarily graphic. Instead, we use literal, precise terms in their primary sense. | [Write inclusive documentation](https://developers.google.com/style/inclusive-documentation), [Voice and tone](https://developers.google.com/style/tone), [Word list](https://developers.google.com/style/word-list) |
| Updated guidance about creating custom heading targets, making anchor (`<a>`) elements equally as acceptable as section (`<section>`) elements. | [Make headings into link targets](https://developers.google.com/style/headings-targets) |
| Added guidance about ensuring that you contextualize UI elements when you document them outside of a numbered procedure. | [UI elements and interaction](https://developers.google.com/style/ui-elements) |
| Added word list entry: *managed instance group (MIG)* | [Word list](https://developers.google.com/style/word-list) |

## April 7, 2026

| New guidance or change | Page |
|---|---|
| Added guidance about avoiding inconsistent end punctuation in list items. | [Lists](https://developers.google.com/style/lists) |
| Added *do the following* as a recommended phrase for introducing lists in procedures. | [Procedures](https://developers.google.com/style/procedures) |
| Clarified that ordered lists are appropriate for any list where sequence is significant. Added guidance about ensuring that it's clear whether the items in an unordered list are required or optional. | [Lists](https://developers.google.com/style/lists) |
| Added guidance that if you must refer to a step number, use the numeral. | [Numbers](https://developers.google.com/style/numbers) |
| Added guidance to use italics sparingly, and consolidated italics guidance into a new page. | [Use italics to discuss terms](https://developers.google.com/style/italics-terms), [Text-formatting summary](https://developers.google.com/style/text-formatting) |
| Added guidance recommending the terms *selected* and *not selected* to refer to the state of a checkbox. | [UI elements and interaction](https://developers.google.com/style/ui-elements) |
| Changed guidance to recommend using code font for IP addresses and port numbers. Added package names to the list of items to place in code font. | [Code in text](https://developers.google.com/style/code-in-text) |
| Updated UI elements guidance with expanded definitions for *pane*, *panel*, and *section*. Added guidance about how to identify difficult-to-find UI elements without using directional language. | [UI elements and interaction](https://developers.google.com/style/ui-elements) |
| Added `.wasm` (Wasm file) to the table of file extensions and corresponding file type names. | [Filenames and file types](https://developers.google.com/style/filenames) |
| Reorganized and extended guidance about formatting abbreviation introductions. | [Abbreviations](https://developers.google.com/style/abbreviations), [Text-formatting summary](https://developers.google.com/style/text-formatting) |
| Consolidated pluralization guidance into a new page, including guidance about abbreviations, product names, and code elements. | [Pluralization](https://developers.google.com/style/pluralization) |
| Restructured guidance about writing for a global audience to make it easier to navigate. | [Write for a global audience](https://developers.google.com/style/translation) |
| Expanded guidance about exclamation marks to clarify that we avoid them except in rare cases. | [Periods and other end punctuation](https://developers.google.com/style/periods), [Voice and tone](https://developers.google.com/style/tone) |
| Created a page about how to format common mathematical notation. | [Mathematical notation](https://developers.google.com/style/mathematical-notation), [Numbers](https://developers.google.com/style/numbers), [Text-formatting summary](https://developers.google.com/style/text-formatting), [Units of measurement](https://developers.google.com/style/units-of-measure) |
| Changed guidance for temperatures to recommend a nonbreaking space between a numeral and the degree symbol instead of between the degree symbol and the temperature scale. | [Units of measurement](https://developers.google.com/style/units-of-measure) |
| Added guidance about marking headings as optional. Restructured headings guidance to make it easier to navigate. | [Headings and titles](https://developers.google.com/style/headings) |
| Added an entry for *AI*, specifying that it rarely needs to be spelled out. | [Word list](https://developers.google.com/style/word-list), [Abbreviations](https://developers.google.com/style/abbreviations) |
| Clarified that the word *can* can be used to convey both permission and ability. | [Word list](https://developers.google.com/style/word-list) |
| Clarified that when we mark a term "Use with caution" in the word list, we recommend following our standard jargon guidance. | [Word list](https://developers.google.com/style/word-list) |
| Clarified how we prefer to distinguish between a *page* (the whole web page) and a *document* (the text on a page that explains a product, feature, or service). | [Word list](https://developers.google.com/style/word-list) |
| Revised the entry for *style sheet* to also allow for *stylesheet*, prioritizing consistency in a document. | [Word list](https://developers.google.com/style/word-list) |
| Added explanations to several existing word list items regarding compound word usage: *clickthrough*, *hardcode*, *high availability*, *load balancing*, *plugin*, *third-party*, *time zone*, and *wake lock*. | [Word list](https://developers.google.com/style/word-list) |
| Expanded the entry for *first class*, *first-class*, *first-class citizen*, providing new recommended alternatives with examples. | [Word list](https://developers.google.com/style/word-list), [Write inclusive documentation](https://developers.google.com/style/inclusive-documentation) |
| Expanded or added entries for *like*, *such as*, *for example*, and *for instance*. Made corresponding updates to the page about writing examples. | [Word list](https://developers.google.com/style/word-list), [Format examples](https://developers.google.com/style/format-examples) |
| Added guidance to the *virtual machine (VM) instance* entry regarding Compute Engine instances. | [Word list](https://developers.google.com/style/word-list) |

## May 8, 2025

| New guidance or change | Page |
|---|---|
| Removed outdated language that indicated that a list of options is treated differently than other unordered lists. | [Lists](https://developers.google.com/style/lists) |
| Added a page about writing prescriptive documentation. | [Prescriptive documentation](https://developers.google.com/style/prescriptive-documentation), [Word list](https://developers.google.com/style/word-list#should) |
| Removed guidance that said to include empty parentheses after method names. | [Code in text](https://developers.google.com/style/code-in-text) |
| Changed footnotes guidance to recommend using numbers instead of symbols. | [Footnotes](https://developers.google.com/style/footnotes) |
| Simplified contractions guidance, removing excess explanations and examples. | [Contractions](https://developers.google.com/style/contractions) |
| Added examples to guidance about introducing sections of a document. | [Headings and titles](https://developers.google.com/style/headings) |
| Added an example service account ID. | [Example domains and names](https://developers.google.com/style/examples) |
| Simplified and clarified guidance about articles, including using articles before abbreviations and product names. | [Abbreviations](https://developers.google.com/style/abbreviations), [Articles (a, an, the)](https://developers.google.com/style/articles), [Product names](https://developers.google.com/style/product-names), [Word list](https://developers.google.com/style/word-list) |
| Included a general explanation of why we don't document future features. | [Document future features](https://developers.google.com/style/future) |
| Revised guidance to recommend using an abbreviation in a title or heading only if the abbreviation is the more commonly known version of the word. | [Headings and titles](https://developers.google.com/style/headings) |
| Added a suggestion that when you use an imperative in running text, consider whether to write a procedure instead. | [Second person and first person](https://developers.google.com/style/person) |
| Generalized existing guidance on what to do when jargon is part of a command or code sample. | [Jargon](https://developers.google.com/style/jargon) |
| Consolidated guidance about cross-references and linking into one page. | [Cross-references and linking](https://developers.google.com/style/cross-references) |
| Added some specific reasons why we avoid directional language when orienting the reader to information on a page. | [Write accessible documentation](https://developers.google.com/style/accessibility) |
| Clarified that spacing around icons is a judgment call based on readability. | [UI elements and interaction](https://developers.google.com/style/ui-elements) |
| Removed an example phone number. | [Example domains and names](https://developers.google.com/style/examples) |
| Removed the word list entry for *property* because its usage heavily depends on the technical context. | [Word list](https://developers.google.com/style/word-list) |
| New word list entries: *choose*, *confidential*, *sensitive*, *image*, *Fast Healthcare Interoperability Resources (FHIR)* | [Word list](https://developers.google.com/style/word-list) |

## January 17, 2025

| New guidance or change | Page |
|---|---|
| Consolidated spelling guidance into the introduction to the word list. Extended guidance about how to use the preferred dictionary to determine which spelling to use for a word with multiple spellings. | [Word list](https://developers.google.com/style/word-list) |
| Generalized guidance about when to use spaces or tabs for indentation in code samples. | [Code samples](https://developers.google.com/style/code-samples#guidelines) |
| Changed guidance for formatting telephone numbers to recommend using dashes instead of parentheses to set the area code off from the rest of the number. | [Format phone numbers](https://developers.google.com/style/phone-numbers) |
| Extended and clarified recommendation to avoid the abbreviations *i.e.*, *e.g.*, and *etc.* in most cases. | [Abbreviations](https://developers.google.com/style/abbreviations#dont-use), [Comma-separated lists](https://developers.google.com/style/lists#comma-separated-lists) |

## October 29, 2024

| New guidance or change | Page |
|---|---|
| Consolidated and expanded guidance about hyphens and closed compounds. | [Hyphens](https://developers.google.com/style/hyphens) |
| Added *hotspot* to the word list. | [Word list](https://developers.google.com/style/word-list#hotspot) |

## August 15, 2024

| New guidance or change | Page |
|---|---|
| Added guidance for distinguishing between binary and decimal units, such as gibibytes (GiB) and gigabytes (GB). Also corrected abbreviation of *kilobyte* to *kB*. | [Decimal and binary units](https://developers.google.com/style/units-of-measure#byte-units) |
| Expanded guidance for referring to figures and other images in text. Clarified that figure numbers are not required. | [Figure captions](https://developers.google.com/style/images#figure-captions) |
| Added word list entries: *curl*, *whitepaper*, *long-running operation* | [Word list](https://developers.google.com/style/word-list) |
| Updated word list entries: *ingest*, *execute*, *content type*, *media type*, *MIME* | [Word list](https://developers.google.com/style/word-list) |

## May 16, 2024

| New guidance or change | Page |
|---|---|
| Added the term *generative AI*. | [Word list](https://developers.google.com/style/word-list#generative-ai) |
| Added the term *rehost*. Redirected the definition for *lift and shift* to *rehost*. | [Word list](https://developers.google.com/style/word-list#rehost) |
| Clarified that the style guide shows examples of how placeholders render but doesn't explain how to implement this visual styling. | [Format placeholders](https://developers.google.com/style/placeholders) |
| Added an example to the guidance showing how to use site-root-relative URLs to link to another page on the same server. | [Cross-references](https://developers.google.com/style/cross-references#same-server) |
| Clarified guidance about how to format anchor text. | [Make headings into link targets](https://developers.google.com/style/headings-targets#markdown) |

## March 21, 2024

| New guidance or change | Page |
|---|---|
| Expanded guidance about avoidance of the term *drop-down*. | [Word list](https://developers.google.com/style/word-list#drop-down) |
| Added examples to guidance about writing documentation that focuses on the present state of the software. | [Timeless documentation](https://developers.google.com/style/timeless-documentation) |
| Added recommendation to use a more precise term than *workload* when possible, or to define what the term means in the specific context. Added related guidance about avoiding ambiguous or overloaded words like *workload*, *solution*, and *support*, or defining them in each context. | [Word list](https://developers.google.com/style/word-list#workload), [Jargon](https://developers.google.com/style/jargon) |
| Aligned guidance with XML and HTML specifications to recommend against the use of angle brackets as part of an element name, but instead to only use angle brackets as part of a tag. | [Code in text](https://developers.google.com/style/code-in-text) |

## January 22, 2024

| New guidance or change | Page |
|---|---|
| Cleaned up word list by removing entries that only provided [hyphenation](https://developers.google.com/style/hyphens), [spelling](https://developers.google.com/style/spelling), or [abbreviation](https://developers.google.com/style/abbreviations) guidance that followed directly from our general guidance. | [Word list](https://developers.google.com/style/style/word-list) |
| Consolidated and clarified guidance regarding alt text, figure captions, and figure descriptions. | [Diagrams, figures, and other images](https://developers.google.com/style/images) [Write accessible documentation](https://developers.google.com/style/accessibility) |
| Added recommendation to avoid linking to other document sets from navigation controls such as a table of contents. | [Links to other sites](https://developers.google.com/style/links-external) |
| Clarified guidance about avoiding words such as *above* and *below* in references to documentation and user interfaces for accessibility reasons, and provided example of appropriate non-directional usage. | [Word list](https://developers.google.com/style/word-list#above) |
| Removed prohibition against hyphenation of the phrase *open source*, so this term now follows our general guidance for hyphenation, which allows for hyphenation of an adjectival phrase to add clarity and remove ambiguity. | [Word list](https://developers.google.com/style/word-list#open-source) |
| Changed guidance for indicating the omission of code from an instructional code snippet to recommend the use of an explanatory comment instead of a mere ellipsis. | [Code samples](https://developers.google.com/style/code-samples) |

## November 8, 2023

| New guidance or change | Page |
|---|---|
| Changed guidance regarding run-in headings in description lists to recommend that the punctuation (such as a colon) is not formatted as bold. Making the punctuation bold caused the punctuation to seem to be part of the heading string, which caused confusion in cases such as UI labels. | [Lists](https://developers.google.com/style/lists#description-lists-that-use-run-in-headings) |
| Removed the recommendation to use a special *external* icon (indicated by `class="external"`) for links. Readers and writers have expressed confusion about the meaning and usage of this icon. We strengthened guidance about using other, explicit means to inform the reader about the destination and behavior of a link. | [Link text](https://developers.google.com/style/link-text#write-link-text) |

## October 24, 2023

| New guidance or change | Page |
|---|---|
| Removed page about custom font styling, which only said to use styles defined in the style sheet for the website. Redirected link to page about HTML formatting and semantic tagging. | [HTML and semantic tagging](https://developers.google.com/style/fonts) |
| Added word-list entry for *then* and expanded entry for *if* to recommend the use of the optional helper word *then* in many cases in which it might be omitted in casual usage. | [Word list](https://developers.google.com/style/word-list#then) |
| Simplified and unified guidance for *jank* and *janky* to recommend that these terms only be used for specific graphics issues. | [Word list](https://developers.google.com/style/word-list#jank) |
| Strengthened guidance against the use of *and/or* except in cases where space is limited. | [Slashes](https://developers.google.com/style/slashes#and-or) |

## September 29, 2023

| New guidance or change | Page |
|---|---|
| Added several examples of when and how to use quotation marks. | [Quotation marks](https://developers.google.com/style/quotation-marks) |
| Added explanation of guidance against anthropomorphism. | [Anthropomorphism](https://developers.google.com/style/anthropomorphism) |
| Added guidance about using a hyphen with the prefix *non* before hyphenated compounds. | [Hyphens](https://developers.google.com/style/hyphens) |

## August 24, 2023

| New guidance or change | Page |
|---|---|
| Added link buttons to each entry in the word list to make deep-linking to individual entries easier. | [Word list](https://developers.google.com/style/word-list) |
| Extended guidance about example names to recommend using an initial to represent a person's surname. | [Example person surnames](https://developers.google.com/style/examples#example-person-surnames) |
| Clarified guidance about when to use present tense and when to use future tense. | [Present tense](https://developers.google.com/style/tense) |
| Extended link text guidance to include an example for `mailto` links. | [Link text](https://developers.google.com/style/link-text) |

## July 26, 2023

| New guidance or change | Page |
|---|---|
| Added link to [Google API guidelines](https://google.aip.dev/192) for information about code comments. | [API reference code comments](https://developers.google.com/style/api-reference-comments) |
| Revised guidance for the word *toggle* to recommend against use as a verb. | [UI elements and interaction](https://developers.google.com/style/ui-elements#term-toggle) |
| Extended and clarified guidance for names for directories and files. | [Filenames and file types](https://developers.google.com/style/filenames) |
| Added explanation for why to use code format for code items. | [Code in text](https://developers.google.com/style/code-in-text) |

## June 15, 2023

| New guidance or change | Page |
|---|---|
| Consolidated guidance about periods and end punctuation. Also removed standalone pages about exclamation points and about spacing after periods. | [Periods and other end punctuation](https://developers.google.com/style/periods) |
| Revised guidance about hyphens to suggest a lookup strategy, categorize uses, and note exceptions. | [Hyphens](https://developers.google.com/style/hyphens) |
| Created firmer guidance about punctuation in lists for run-in headings and at the end of list items. | [Lists](https://developers.google.com/style/lists) |
| Strengthened capitalization guidance: when *not* to use capitalization, and how to use capitalization with product names. | [Capitalization](https://developers.google.com/style/capitalization), [Product names](https://developers.google.com/style/product-names) |
| Added guidance about using end punctuation when documenting a command-line option or argument. | [Document command-line syntax](https://developers.google.com/style/code-syntax) |
| Improved description and examples for using first-person pronouns (*we*, *our*). | [Second person and first person](https://developers.google.com/style/person) |
| Updated word list entries: *etc.*, *OK*, *user*, *we*, *you* | [Word list](https://developers.google.com/style/word-list) |

## May 9, 2023

| New guidance or change | Page |
|---|---|
| Softened guidance regarding the choice between the pronouns *who* and *that*. | [Pronouns](https://developers.google.com/style/pronouns) |
| Added *web interface* as an alternative to *console* and *UI* in general references to a browser-based interface. | [Word list](https://developers.google.com/style/word-list#ui) |
| Clarified the purpose of the page about phone number formats. | [Format phone numbers in text](https://developers.google.com/style/phone-numbers) |

## March 31, 2023

| New guidance or change | Page |
|---|---|
| Expanded and clarified guidance about using trademarks only as modifiers. This guidance emphasizes that you should never modify a trademark, such as by creating a possessive or plural form. | [Use trademarks only as modifiers](https://developers.google.com/style/trademarks#use-trademarks-only-as-modifiers) |
| Strengthened guidance against shortening product names to anything other than an approved alternative name. | [Google product names](https://developers.google.com/style/product-names#shortening) |
| Expanded guidance about using ARIA labels in text that describes icons in graphical user interfaces. This improves accessibility and increases consistency in terminology used to refer to visual elements in text. | [Buttons and icons](https://developers.google.com/style/ui-elements#buttons), [Accessibility](https://developers.google.com/style/accessibility) |
| New word list entry: *toolkit* | [Word list](https://developers.google.com/style/word-list) |

## February 13, 2023

| New guidance or change | Page |
|---|---|
| Added a page about paragraph structure, which provides guidance about recommended paragraph length and order of information. | [Paragraph structure](https://developers.google.com/style/paragraph-structure) |
| Expanded accessibility guidance to say that a document should convey its information when you use it without images or animation. | [Write accessible documentation](https://developers.google.com/style/accessibility) |
| Clarified that letter keys should be represented with uppercase letters. | [Press and type keyboard keys](https://developers.google.com/style/ui-elements#keyboard) |
| Added *existing* to list of examples of potentially problematic words in timeless documentation. | [Timeless documentation](https://developers.google.com/style/timeless-documentation) |
| Recommended using an empty `alt` attribute for icons that include a text label. | [Buttons and icons](https://developers.google.com/style/ui-elements#buttons) |
| Strengthened and clarified guidance about avoiding culturally specific references and about using simple and consistent language. | [Voice and tone](https://developers.google.com/style/tone) |
| Created section about items that are sometimes---but not always---formatted in code font, such as email addresses. | [Items that are sometimes in code font](https://developers.google.com/style/code-in-text#sometimes) |
| Added information about example internationalized domain names. | [Example domain names](https://developers.google.com/style/examples#domains) |
| Expanded guidance about choosing example email addresses. | [Example email addresses](https://developers.google.com/style/examples#addresses) |
| Expanded guidance about using second-person *you* to refer to the reader of a document and, generally, using third-person *user* to refer to the intended user of the software that the reader is developing. | [Second person](https://developers.google.com/style/person) |

## December 12, 2022

| New guidance or change | Page |
|---|---|
| New word list entry: *anti-pattern* | [Word list](https://developers.google.com/style/word-list) |

## November 7, 2022

| New guidance or change | Page |
|---|---|
| To emphasize a negative, use `<em>`not`</em>`. | [Contractions](https://developers.google.com/style/contractions) |

## October 31, 2022

| New guidance or change | Page |
|---|---|
| New word list entry: *standalone* | [Word list](https://developers.google.com/style/word-list) |

## October 10, 2022

| New guidance or change | Page |
|---|---|
| Added guidance about how to document optional arguments for commands. Special characters that indicate optional and mutually exclusive arguments in commands---such as brackets, braces, and pipes---break commands if the user doesn't edit them first. The new guidance offers several approaches for avoiding these problems. | [Code in text](https://developers.google.com/style/code-in-text), [Code samples](https://developers.google.com/style/code-samples), [Document command-line syntax](https://developers.google.com/style/code-syntax) |
| Clarified that contractions are recommended in general, but not required in all cases. | [Contractions](https://developers.google.com/style/contractions) |

## September 26, 2022

| New guidance or change | Page |
|---|---|
| In figure captions, always use end punctuation, and use complete sentences when possible. | [Figures and other images](https://developers.google.com/style/images) |
| Added separators between word list terms, to improve readability. | [Word list](https://developers.google.com/style/word-list) |

## September 19, 2022

| New guidance or change | Page |
|---|---|
| Added guidance to multiple pages about ways to make documentation more inclusive for readers who have a variety of cognitive patterns. | [Write accessible documentation](https://developers.google.com/style/accessibility), [Cross-references](https://developers.google.com/style/cross-references), [Numbers](https://developers.google.com/style/numbers), [Procedures](https://developers.google.com/style/procedures) |

## September 12, 2022

| New guidance or change | Page |
|---|---|
| Don't present new information in tables through images or symbols alone. | [Tables](https://developers.google.com/style/tables) |
| Clarified guidance about using footnotes in tables. | [Tables](https://developers.google.com/style/tables) |
| Added instructions for how to look up a UI element's `aria-label` attribute. | [UI elements and interaction](https://developers.google.com/style/ui-elements) |

## September 5, 2022

| New guidance or change | Page |
|---|---|
| Strengthened recommendation to avoid using semicolons where possible, and removed basic information about semicolons. Our [accessibility guidance](https://developers.google.com/style/accessibility) recommends against using semicolons where possible, because screen readers may not clearly indicate them. So we changed our semicolon guidance to be more in line with our accessibility guidance. | [Semicolons](https://developers.google.com/style/semicolons) |
| Expanded and clarified guidance about what to put in code font. | [Code in text](https://developers.google.com/style/code-in-text) |

## August 29, 2022

| New guidance or change | Page |
|---|---|
| Changed and clarified recommended phrasing for describing boolean parameters in reference docs. | [API reference code comments](https://developers.google.com/style/api-reference-comments) |
| Expanded and clarified explanation of why we use straight quotation marks and apostrophes. | [Quotation marks](https://developers.google.com/style/quotation-marks) |
| Added suggested alternative terms for *cloud-native*. | [Word list](https://developers.google.com/style/word-list) |
| New word list entries: *prebuilt*, *scroll* | [Word list](https://developers.google.com/style/word-list) |

## August 22, 2022

| New guidance or change | Page |
|---|---|
| Clarified that *and then* is generally better than just *then*. | [Write for a global audience](https://developers.google.com/style/translation) |
| New word list entries: *canary*, *multi-service*, *precapture*, *pre-existing*, *presubmit*, *rebranding*, *roll out* | [Word list](https://developers.google.com/style/word-list) |

## August 15, 2022

| New guidance or change | Page |
|---|---|
| Expanded table-formatting guidance, to improve accessibility. | [Tables](https://developers.google.com/style/tables) |
| Improved guidance about figure captions, descriptions, and alt text. | [Figures and other images](https://developers.google.com/style/images) |

## August 8, 2022

| New guidance or change | Page |
|---|---|
| Write *a SQL* rather than *an SQL*. Both are in use, but *a SQL* is significantly more common. | [Articles (a, an, the)](https://developers.google.com/style/articles) |
| Added information about our distinction between *don't use* and *avoid*. | [Word list](https://developers.google.com/style/word-list) |
| New word list entries: *nonce*, *SQL* | [Word list](https://developers.google.com/style/word-list) |

## August 1, 2022

| New guidance or change | Page |
|---|---|
| Expanded guidance about *mobile* and related terms. | [Word list](https://developers.google.com/style/word-list) |
| It's OK to use *below* in set phrases such as *below (the) average*. | [Word list](https://developers.google.com/style/word-list) |
| Expanded our information about serial commas. | [Commas](https://developers.google.com/style/commas) |
| To refer to a file with the `.tiff` extension, use the phrase *TIFF file*. | [Filenames and file types](https://developers.google.com/style/filenames) |
| New word list entries: *admin*; *blue-green*; *cold*, *hot*, and *warm* (in the context of a failover, spare, or standby); *inline*; *mobile phone*; *online* | [Word list](https://developers.google.com/style/word-list) |

## July 25, 2022

| New guidance or change | Page |
|---|---|
| Updated guidance about the term *Cloud console*. | [Word list](https://developers.google.com/style/word-list) |
| Clarified guidance about the term *see*. | [Word list](https://developers.google.com/style/word-list) |

## July 18, 2022

| New guidance or change | Page |
|---|---|
| Revised guidance about using the term *element* in HTML and XML contexts. | [Word list](https://developers.google.com/style/word-list) |
| Revised and expanded guidance about how to form possessives. | [Possessives](https://developers.google.com/style/possessives) |
| New word list entry: *tag* | [Word list](https://developers.google.com/style/word-list) |

## June 20, 2022

| New guidance or change | Page |
|---|---|
| New word list entry: *brown bag* | [Word list](https://developers.google.com/style/word-list) |

## June 13, 2022

| New guidance or change | Page |
|---|---|
| Clarified guidance about placement of *only*. | [Write for a global audience](https://developers.google.com/style/translation) |
| New word list entry: *using* | [Word list](https://developers.google.com/style/word-list) |

## June 6, 2022

| New guidance or change | Page |
|---|---|
| Clarified guidance about *Interconnect connection*. | [Word list](https://developers.google.com/style/word-list) |

## May 16, 2022

| New guidance or change | Page |
|---|---|
| Offset footnote symbols using superscript. | [Footnotes](https://developers.google.com/style/footnotes) |
| New word list entries: *could*, *would* | [Word list](https://developers.google.com/style/word-list) |

## May 9, 2022

| New guidance or change | Page |
|---|---|
| Strengthened guidance recommending avoiding humor in documentation. Most humor is difficult to translate, and much humor is culturally specific. | [Write for a global audience](https://developers.google.com/style/translation) |
| Changed the link to a resource about identity-first language. The site that we had previously linked to has disappeared. | [Write inclusive documentation](https://developers.google.com/style/inclusive-documentation) |

## April 25, 2022

| New guidance or change | Page |
|---|---|
| Added a new page about jargon. | [Jargon](https://developers.google.com/style/jargon) |
| Expanded guidance about when to use the various notice types. | [Notes, cautions, warnings, and other notices](https://developers.google.com/style/notices) |
| Clarified and expanded guidance about when to remove locales from URLs. | [Link to other sites](https://developers.google.com/style/links-external) |
| New word list entries: *final solution*, `*gsutil*` | [Word list](https://developers.google.com/style/word-list) |

## April 18, 2022

| New guidance or change | Page |
|---|---|
| Introduce an interactive element (such as a button that expands and collapses) in the text preceding the element, to improve accessibility. | [Write accessible documentation](https://developers.google.com/style/accessibility) |

## April 11, 2022

| New guidance or change | Page |
|---|---|
| Changed guidance about taking screenshots. | [Figures and other images](https://developers.google.com/style/images) |
| In code samples, indicate omitted code using three dots and no spaces (`...`) | [Code samples](https://developers.google.com/style/code-samples) |
| New word list entries: *+* (appended to numbers in text) | [Word list](https://developers.google.com/style/word-list) |

## April 4, 2022

| New guidance or change | Page |
|---|---|
| Removed guidance about using lettered lists for mutually exclusive options. The semantic distinction that we were making isn't in wide use, and lettered lists aren't supported in standard Markdown, so we no longer recommend using lettered lists. | [Lists](https://developers.google.com/style/lists) |
| Clarified recommendation about how to italicize in Markdown. | [Text-formatting summary](https://developers.google.com/style/text-formatting) |
| Changed guidance about *dead-letter queue* and *hold the pointer over*. | [Word list](https://developers.google.com/style/word-list) |
| New word list entry: *break-glass* | [Word list](https://developers.google.com/style/word-list#break-glass) |

## March 28, 2022

| New guidance or change | Page |
|---|---|
| Clarified guidance about using an introductory phrase before the output of a command. | [Document command-line syntax](https://developers.google.com/style/code-syntax) |
| New word list entry: *Unicode* | [Word list](https://developers.google.com/style/word-list#unicode) |

## February 21, 2022

| New guidance or change | Page |
|---|---|
| Use `*gcloud*` *CLI* instead of `*gcloud*` *command-line tool*. | [Word list](https://developers.google.com/style/word-list) |
| New word list entry: *shift left* | [Word list](https://developers.google.com/style/word-list) |

## February 7, 2022

| New guidance or change | Page |
|---|---|
| In general, don't use a single *x* or a series of *x*'s as placeholders; instead, use a more informative placeholder. | [Formatting placeholders](https://developers.google.com/style/placeholders) |
| New word list entry: *GBps* | [Word list](https://developers.google.com/style/word-list) |

## January 31, 2022

| New guidance or change | Page |
|---|---|
| Avoid repeating the exact page title as a heading on the page. | [Headings and titles](https://developers.google.com/style/headings) |
| Expanded guidance about *runtime* and *run time*. | [Word list](https://developers.google.com/style/word-list) |
| Added *.adoc* and *.md* to the list of examples of filename extensions. | [Filenames and file types](https://developers.google.com/style/filenames#file-type-names) |

## January 24, 2022

| New guidance or change | Page |
|---|---|
| Clarified guidance about video formats. The main reason to avoid using animated GIF is that it's resource-inefficient. | [Figures and other images](https://developers.google.com/style/images) |
| Clarified guidance about changing an existing custom anchor for a heading. | [Making headings into link targets](https://developers.google.com/style/headings-targets) |

## January 18, 2022

| New guidance or change | Page |
|---|---|
| For animations and videos, use a compressed format (such as MP4), not animated GIF. | [Figures and other images](https://developers.google.com/style/images) |
| Don't use *email* as a verb. | [Word list](https://developers.google.com/style/word-list) |
| New word list entry: *healthcare* | [Word list](https://developers.google.com/style/word-list) |

## December 31, 2021

| New guidance or change | Page |
|---|---|
| Added headings to make guidance about using simple and unambiguous language easier to find. | [Writing for a global audience](https://developers.google.com/style/translation#clear-language) |
| Expanded guidance about demonstrative pronouns. | [Ambiguous pronoun references](https://developers.google.com/style/pronouns#ambiguous-pronoun-references) |
| Clarified guidance about when to use code format for URLs. | [Code in text](https://developers.google.com/style/code-in-text) |
| Refreshed guidance about optimizing for search (SEO). | [Text for images](https://developers.google.com/style/images#text-associated-with-images), [Link text](https://developers.google.com/style/link-text), [Filenames](https://developers.google.com/style/filenames), [Headings](https://developers.google.com/style/headings) |

## November 30, 2021

| New guidance or change | Page |
|---|---|
| Added examples and clarified guidance recommending use of optional pronouns and other helper words. | [Optional pronouns](https://developers.google.com/style/pronouns#optional-pronouns), [Writing for a global audience](https://developers.google.com/style/translation#write-short,-clear,-and-precise-sentences) |
| Added guidance for linking to a section of another page. | [Links to sections on another page](https://developers.google.com/style/cross-references#different-page) |
| New word list entries: *portal*, *copy and paste*, *performant* | [Word list](https://developers.google.com/style/word-list) |

## November 1, 2021

| New guidance or change | Page |
|---|---|
| Added guidance about expanding shortened words and symbols. | [Abbreviations](https://developers.google.com/style/abbreviations#dont-use) |
| Expanded guidance about the order of information in complex procedures, including the recommended order for goals, results, and justifications for steps. | [Procedures](https://developers.google.com/style/procedures#order-of-information-in-complex-steps) |
| Added guidance about including a description of default behaviors in API reference documents. | [API reference code comments](https://developers.google.com/style/api-reference-comments#parameters) |
| Reinforced guidance about including words like *file* after items in code font, such as filenames. | [Filenames](https://developers.google.com/style/filenames) |
| Added guidance about using alternatives to directional terms such as *above* and *below* when referring to location in a document. | [Writing accessible documentation](https://developers.google.com/style/accessibility#document-rendering) |
| New word list entries: *practitioner*, *left-nav, right-nav*, *create new* | [Word list](https://developers.google.com/style/word-list) |

## October 11, 2021

| New guidance or change | Page |
|---|---|
| Simplified placeholder examples and clarified when to repeat an explanation for a placeholder. | [Formatting placeholders](https://developers.google.com/style/placeholders#explaining-placeholders) |
| Added guidance on using brackets and dots (`[...]`) to indicate omitted output in an example. | [Output from commands](https://developers.google.com/style/code-syntax#output) |

## October 4, 2021

| New guidance or change | Page |
|---|---|
| Added page about philosophy and principles of the style guide. | [Philosophy of this style guide](https://developers.google.com/style/philosophy) |
| Clarified recommendation to include a noun after a code element and to avoid inflecting code elements. | [Code in text](https://developers.google.com/style/code-in-text) |
| Added guidance to not use numbers in headings to indicate a sequence of sections. | [Headings and titles](https://developers.google.com/style/headings) |
| Updated examples for verb forms in headings and titles, including special cases such as *Pricing* and *Billing*. | [Headings and titles](https://developers.google.com/style/headings) |

## September 13, 2021

| New guidance or change | Page |
|---|---|
| Clarified guidance about specifying the context for a task. | [Procedures](https://developers.google.com/style/procedures) |
| Avoid using *run the following command* to introduce code. Instead, focus on what the command does. | [Procedures](https://developers.google.com/style/procedures) |
| Expanded the guidance for *CLI*. | [Word list](https://developers.google.com/style/word-list#cli) |
| New word list entries: *ransomware* | [Word list](https://developers.google.com/style/word-list) |

## September 6, 2021

| New guidance or change | Page |
|---|---|
| Avoid words and phrases that anchor the documentation to a point in time or assume knowledge of prior or future products and features. | [Timeless documentation](https://developers.google.com/style/timeless-documentation) |
| Added *navigation menu* to the list of UI terms. | [UI elements and interaction](https://developers.google.com/style/ui-elements) |
| Marked *slice and dice* as *don't use*. | [Word list](https://developers.google.com/style/word-list#slice) |
| New word list entries: *web application firewall*, *while* | [Word list](https://developers.google.com/style/word-list) |

## August 30, 2021

| New guidance or change | Page |
|---|---|
| Introduce a list of placeholders with the phrase *This output includes the following values:* The old guidance for what introductory phrase to use wasn't a complete sentence. | [Formatting placeholders](https://developers.google.com/style/placeholders) |

## August 16, 2021

| New guidance or change | Page |
|---|---|
| Added guidance for heading and title phrasing. Many writers ask what verb forms to use in headings and titles. The new guidance helps writers make that decision more easily, and it improves consistency for translators and readers. | [Headings and titles](https://developers.google.com/style/headings) |

## August 2, 2021

| New guidance or change | Page |
|---|---|
| When you need an example project name, create a name that's meaningful or descriptive. | [Example domains and names](https://developers.google.com/style/examples) |
| New word list entry: *pop-up* | [Word list](https://developers.google.com/style/word-list#pop-up) |

## July 26, 2021

| New guidance or change | Page |
|---|---|
| New word list entry: *intercluster* | [Word list](https://developers.google.com/style/word-list#intercluster) |

## July 19, 2021

| New guidance or change | Page |
|---|---|
| Added guidance about whether to include an abbreviation if it is used only once in the document. | [Abbreviations](https://developers.google.com/style/abbreviations) |
| Clarified and added guidance about the terms *above*, *below*, *earlier*, *higher*, *later*, *lower*, and *under* | [Word list](https://developers.google.com/style/word-list) |

## July 12, 2021

| New guidance or change | Page |
|---|---|
| Don't refer to casing styles by names like *camel case* or *snake case*. | [Capitalization](https://developers.google.com/style/capitalization#special-capitalization-style-names) |

## July 5, 2021

| New guidance or change | Page |
| In the first sentence of each procedural step, include an imperative verb. | [Procedures](https://developers.google.com/style/procedures) |
|---|---|

## June 28, 2021

| New guidance or change | Page |
|---|---|
| New word list entries: *can*, *might*, *must* A writer asked us to clarify our guidance for these terms. | [Word list](https://developers.google.com/style/word-list) |

## June 21, 2021

| New guidance or change | Page |
|---|---|
| Updated guidance on fictitious person names, and added a list of specific given names to use in examples. Many writers have asked for a list of recommended names to use. | [Example domains and names](https://developers.google.com/style/examples#names) |

## June 7, 2021

| New guidance or change | Page |
|---|---|
| Don't use UI element labels as if they were English verbs or nouns. | [UI elements and interaction](https://developers.google.com/style/ui-elements#referring-to-ui) |

## May 24, 2021

| New guidance or change | Page |
|---|---|
| Clarified phrasing of guidance about avoiding using the same link text for different target pages. | [Link text](https://developers.google.com/style/link-text) |
| Added guidance about what to do when link text includes a command or other code-font element. | [Link text](https://developers.google.com/style/link-text) |
| Try to keep the main subject and verb as close to the beginning of a sentence as possible. | [Writing for a global audience](https://developers.google.com/style/translation) |
| Updated guidance about using a hyphen to indicate a range of numbers. For example, we now recommend using an ordinary hyphen rather than a nonbreaking hyphen, for ease of authoring. | [Hyphens](https://developers.google.com/style/hyphens) |
| Removed the word list entry for *AJAX*. The entry was outdated, and Wikipedia covers the term better. | [Word list](https://developers.google.com/style/word-list) |
| New word list entries: *webmaster*, *white label* Use more specific terms. | [Word list](https://developers.google.com/style/word-list) |

## May 3, 2021

| New guidance or change | Page |
|---|---|
| Don't put a link in a heading. A link in a heading is easy for a reader to miss. | [Headings and titles](https://developers.google.com/style/headings#formatting-a-heading-or-title) |
| Clarified and reorganized the material about which preposition to use with each UI element. | [UI elements and interaction](https://developers.google.com/style/ui-elements#prepositions) |

## April 26, 2021

| New guidance or change | Page |
|---|---|
| Clarified guidance about when to create a custom anchor for a heading. | [Making headings into link targets](https://developers.google.com/style/headings-targets) |

## April 19, 2021

| New guidance or change | Page |
|---|---|
| Write one-step procedures with a bullet. | [Procedures](https://developers.google.com/style/procedures) |
| In headings, use punctuation sparingly. | [Headings and titles](https://developers.google.com/style/headings) |
| Added a link to another resource about active and passive voice. | [Active voice](https://developers.google.com/style/voice) |
| Clarified guidance about the word *native*. | [Word list](https://developers.google.com/style/word-list) |
| New entry: *sherpa* | [Word list](https://developers.google.com/style/word-list) |

## April 12, 2021

| New guidance or change | Page |
|---|---|
| Clarified that guidance that applies to text generally also applies to headings. | [Headings and titles](https://developers.google.com/style/headings) |
| Strengthened recommendation to use contractions. | [Contractions](https://developers.google.com/style/contractions) |
| New entry: *downscope* | [Word list](https://developers.google.com/style/word-list) |

## April 5, 2021

| New guidance or change | Page |
|---|---|
| Expanded guidance about using simple words and phrases. | [Writing for a global audience](https://developers.google.com/style/translation) |
| New entry: *instance group* | [Word list](https://developers.google.com/style/word-list) |

## March 29, 2021

| New guidance or change | Page |
|---|---|
| To form the plural of an abbreviation, treat the abbreviation like an English word, and follow standard English pluralizing patterns. | [Abbreviations](https://developers.google.com/style/abbreviations) |

## March 15, 2021

| New guidance or change | Page |
|---|---|
| New entries: more than 60 terms to not use or to use with caution, for inclusive-language reasons (too many to list here) | [Word list](https://developers.google.com/style/word-list) |

## March 8, 2021

| New guidance or change | Page |
|---|---|
| Expanded and clarified guidance about placeholders. | [Formatting placeholders](https://developers.google.com/style/placeholders) |
| New entries: *outside the box* (and related terms), and more than 40 networking terms (too many to list here) | [Word list](https://developers.google.com/style/word-list) |

## March 1, 2021

| New guidance or change | Page |
|---|---|
| Clarified guidance about spelling out an abbreviation. | [Abbreviations](https://developers.google.com/style/abbreviations) |
| Use *documentation set* instead of *docset*. | [Word list](https://developers.google.com/style/word-list) |

## February 15, 2021

| New guidance or change | Page |
|---|---|
| New entry: *lock-in* | [Word list](https://developers.google.com/style/word-list) |

## February 1, 2021

| New guidance or change | Page |
|---|---|
| Revised and clarified guidance about using *should*. | [Word list](https://developers.google.com/style/word-list#should) |
| In some contexts, you can use *active*/*standby* as a replacement for *master*/*slave*. | [Word list](https://developers.google.com/style/word-list#slave) |
| Updated guidance about using *firewalls*. | [Word list](https://developers.google.com/style/word-list#firewalls) |
| New entries: *black-box*, *external IP address*, *gray-box*, *IPsec*, *N/A*, *war room*, *white-box* | [Word list](https://developers.google.com/style/word-list) |

## January 25, 2021

| New guidance or change | Page |
|---|---|
| Updated guidance about link text to remove reliance on external sources. | [Link text](https://developers.google.com/style/link-text) |
| Don't use abbreviations or product names as verbs. | [Abbreviations](https://developers.google.com/style/abbreviations#verbs), [Product names](https://developers.google.com/style/product-names#product-names-as-verbs) |

## January 11, 2021

| New guidance or change | Page |
|---|---|
| Clarified guidance about indentation in code samples. | [Code samples](https://developers.google.com/style/code-samples) |
| Added links to more coding-style guides. | [Code in text](https://developers.google.com/style/code-in-text) |
| Clarified that you can use *please* under certain specific circumstances. | [Word list](https://developers.google.com/style/word-list#please) |
| Clarified guidance about *terminate*. | [Word list](https://developers.google.com/style/word-list#terminate) |
| New entries: *hang*, *MTU*, *utilize* | [Word list](https://developers.google.com/style/word-list) |

## January 4, 2021

| New guidance or change | Page |
|---|---|
| Merged landing page with "Other editorial resources" to help new readers learn how to use this guide. | [About this guide](https://developers.google.com/style) |
| New entry: *deprecate* | [Word list](https://developers.google.com/style/word-list) |

## December 28, 2020

| New guidance or change | Page |
|---|---|
| Added an explanation of what placeholders are. | [Formatting placeholders](https://developers.google.com/style/placeholders) |

## December 14, 2020

| New guidance or change | Page |
|---|---|
| Distinguished between the Google Cloud product called Identity and Access Management (IAM) and the general practice of identity and access management. | [Word list](https://developers.google.com/style/word-list#iam) |
| Clarified that the word *terminate* has a specific meaning in telephony. | [Word list](https://developers.google.com/style/word-list#terminate) |

## December 7, 2020

| New guidance or change | Page |
|---|---|
| When you describe navigating through menus using angle brackets, add an `https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA/ARIA_Techniques/Using_the_aria-label_attribute`[attribute](https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA/ARIA_Techniques/Using_the_aria-label_attribute) to each angle bracket, for use by screen readers: `<span aria-label="and then">></span>`. | [UI elements and interaction](https://developers.google.com/style/ui-elements) |
| New entry: *metageneration* | [Word list](https://developers.google.com/style/word-list) |

## November 30, 2020

| New guidance or change | Page |
|---|---|
| Updated content-navigation titles for some style guide pages. | Content navigation |
| Clarified guidance for *just*. | [Word list](https://developers.google.com/style/word-list) |
| New entry: *time to live* | [Word list](https://developers.google.com/style/word-list) |

## November 23, 2020

| New guidance or change | Page |
|---|---|
| Changed guidance about fictitious email addresses. | [Example domains and names](https://developers.google.com/style/examples) |
| New entry: *holiday, the holidays* | [Word list](https://developers.google.com/style/word-list) |

## November 16, 2020

| New guidance or change | Page |
|---|---|
| In examples, use fictional street addresses. | [Example domains and names](https://developers.google.com/style/examples) |
| Clarified guidance for *functionality*. | [Word list](https://developers.google.com/style/word-list) |

## November 9, 2020

| New guidance or change | Page |
|---|---|
| Format folder and directory names in code font. | [Code in text](https://developers.google.com/style/code-in-text) |

## November 2, 2020

| New guidance or change | Page |
|---|---|
| Avoid double negatives. | [Writing accessible documentation](https://developers.google.com/style/accessibility) |
| Expanded guidance about how to write around unavoidable references to non-inclusive words. | [Writing inclusive documentation](https://developers.google.com/style/inclusive-documentation) |

## October 19, 2020

We're changing the format of the updates to this page, to focus on what each
change is rather than where it is.

| New guidance or change | Page |
|---|---|
| You can use an asterisk to indicate emphasis in Markdown. Don't use a double underscore to indicate bold in Markdown. | [Text-formatting summary](https://developers.google.com/style/text-formatting) |

## October 12, 2020

| New guidance or change | Page |
|---|---|
| Use *enable* or *turn on* consistently. | [Word list](https://developers.google.com/style/word-list#enable) |
| All pages about linking are now grouped together under a new **Linking** heading. | Content navigation |
| Don't link to the same document multiple times in close succession. | [Cross-references](https://developers.google.com/style/cross-references#references-to-other-documents) |
| For subsections, use the phrase *in the following sections*. | [Headings and titles](https://developers.google.com/style/headings#referring-to-subsections) |
| Don't create your own abbreviations. | [Abbreviations](https://developers.google.com/style/abbreviations#creating-abbreviations) |
| Don't reveal personally identifiable information. | [Example domains and names](https://developers.google.com/style/examples) |
| For exponents, use standard mathematical notation. | [Numbers](https://developers.google.com/style/numbers#exponents) |
| Expanded guidance about expressing times of day. | [Dates and times](https://developers.google.com/style/dates-times#expressing-times) |
| New entries: *aka*, *America*, *-aware*, *Black Friday*, *Cyber Monday*, *leverage*, *possible*, *postmortem* | [Word list](https://developers.google.com/style/word-list) |

## October 5, 2020

- In the [word list](https://developers.google.com/style/word-list), updated guidance about the term *disable*.

## September 28, 2020

- On the [Capitalization](https://developers.google.com/style/capitalization) page, expanded guidance about using consistent capitalization.
- On the [Procedures](https://developers.google.com/style/procedures) page, added guidance about including keyboard shortcuts in procedures.

## September 21, 2020

- On the [Figures and other images](https://developers.google.com/style/images) page, added guidance about using image maps.
- On the [Text-formatting summary](https://developers.google.com/style/text-formatting) page, added guidance about using a variable to indicate a range of version numbers, and clarified guidance about using `<em>`.
- Added entries to the [word list](https://developers.google.com/style/word-list): *distributed denial-of-service (DDoS)*, *UTF*.

## September 14, 2020

- On the [Figures and other images](https://developers.google.com/style/images) page and the [Tables](https://developers.google.com/style/tables) page, added guidance about introductory sentences.
- In the [word list](https://developers.google.com/style/word-list), clarified the distinction between terms to never use and terms to avoid when possible. Also added icons for both kinds of terms.

## September 7, 2020

- On the [Writing for a global audience](https://developers.google.com/style/translation) page, clarified guidance about using simple verbs.
- Added entries to the [word list](https://developers.google.com/style/word-list): *single pane of glass*, *will*.

## August 31, 2020

- On the [Figures and other images](https://developers.google.com/style/images) page, clarified guidance about using SVG.

## August 24, 2020

- Added an entry to the [word list](https://developers.google.com/style/word-list): *see*.

## August 10, 2020

- On the [UI elements and interaction](https://developers.google.com/style/ui-elements) page, added guidance about when to use *in* and when to use *on*.
- On the [Making headings into link
  targets](https://developers.google.com/style/headings-targets) page, added guidance about changing anchors, and reorganized the page.

## August 3, 2020

- On the [Dates and times](https://developers.google.com/style/dates-times) page, added guidance about avoiding referring to seasons of the year.
- In the [word list](https://developers.google.com/style/word-list), added more suggested alternatives for *master* and *slave*.

## July 27, 2020

- Added entries to the [word list](https://developers.google.com/style/word-list): *grandfathered*, *graylist*, *greylist*, *multi-regional*, *Unix epoch time*. Expanded and clarified guidance for the *blacklist*, *master*, and *multi-region* entries.

## July 20, 2020

- Reorganized and updated the [Other editorial
  resources](https://developers.google.com/style/resources) page, and moved that page to near the top of the left nav.
- On the [Figures and other images](https://developers.google.com/style/images) page, added links to Web Content Accessibility Guidelines (WCAG) resources.
- On the [Procedures](https://developers.google.com/style/procedures) page, added guidance about introducing a procedure with an imperative.
- Added entries to the [word list](https://developers.google.com/style/word-list): *bar*, *baz*, *canceled*, *foo*, *like*, *such as*.
- As of this week, we've stopped including small-detail changes in this page. For example, when we corrected a typo in the style guide in the past, we used to mention that correction on this page, but we're no longer mentioning minor changes that have no effect on guidance.

## July 13, 2020

- Renamed this summary-of-recent-changes page from "Release notes" to "What's new," and moved it to near the top of the left nav.
- In the [Pronouns](https://developers.google.com/style/pronouns) page, slightly updated the guidance about using gender-neutral *they*.

## June 29, 2020

- On several pages, reorganized guidance about formatting code and command lines. In particular:
  - Moved the guidance that was in a page about command-line terminology to the [Documenting command-line syntax](https://developers.google.com/style/code-syntax) page, and deleted the separate command-line terminology page.
  - Moved the guidance about placeholders to a new [Formatting placeholders](https://developers.google.com/style/placeholders) page.
  - Added cross-references among various code-related pages.
- In the [word list](https://developers.google.com/style/word-list), corrected a typo.

## June 22, 2020

- In the [word list](https://developers.google.com/style/word-list), changed guidance about using *earlier* and *later* for a range of version numbers.

## June 15, 2020

- On the [Capitalization](https://developers.google.com/style/capitalization) page and other pages, made guidance consistent about capitalizing references to document titles.
- On the [Cross-references](https://developers.google.com/style/cross-references) page and other pages, added guidance about not forcing a link to open in a new tab.
- On the [Code in text](https://developers.google.com/style/code-in-text) page, added guidance about when to put UI elements in code font.
- Added an entry to the [word list](https://developers.google.com/style/word-list): *best effort*.

## June 8, 2020

- On the [Writing inclusive
  documentation](https://developers.google.com/style/inclusive-documentation) page, added guidance about avoiding figurative language that relates to the slaughter of animals.

## June 1, 2020

- On the [Figures and other images](https://developers.google.com/style/images) page, updated guidance about alt text, figure descriptions, and figure captions.
- Reorganized the [HTML and semantic
  tagging](https://developers.google.com/style/semantic-tagging) page, and added guidance about not using the [`br`
  element](https://html.spec.whatwg.org/multipage/text-level-semantics.html#the-br-element) to change visual presentation. Also replaced a broken link to a third-party site.
- On the [Numbers](https://developers.google.com/style/numbers) page, added guidance about avoiding using Roman numerals.
- Added entries to the [word list](https://developers.google.com/style/word-list): *currently*, *dash*, *NoOps*.

## May 25, 2020

- On the [Numbers](https://developers.google.com/style/numbers) page, corrected two examples to match our guidance.
- On the [Abbreviations](https://developers.google.com/style/abbreviations) page, added guidance about use of the term *acronym*.
- Added entries to the [word list](https://developers.google.com/style/word-list): *happiness*, *scale*, *service level agreement*, *service level indicator*, *service level objective*. Also clarified guidance for *app*.

## May 18, 2020

- On the [Filenames and file types](https://developers.google.com/style/filenames) page, added guidance about how to refer to a filename.
- On the [Headings and titles](https://developers.google.com/style/headings) page, updated the guidance about using code font in headings.
- On the [UI elements and interaction](https://developers.google.com/style/ui-elements) page and elsewhere, replaced the term *arrow notation* with *angle bracket*.
- On the [Procedures](https://developers.google.com/style/procedures) page, clarified the guidance about stating the location of an action before stating the action.
- Added entries to the [word list](https://developers.google.com/style/word-list): *config*, *extract*, *unarchive*, *uncompress*, *untar*. Also changed the guidance about *ssh* and related terms. Also corrected a typo.

## May 11, 2020

- Major change: On the [Code in text](https://developers.google.com/style/code-in-text) page, changed guidance for placeholder styling. The new preferred style is all-uppercase with underscore delimiters.
- Also on the [Code in text](https://developers.google.com/style/code-in-text) page, corrected guidance about how to mark up placeholders with Markdown.
- On the [Figures and other images](https://developers.google.com/style/images) page, corrected a typo.

## May 4, 2020

- On the [Second person and first person](https://developers.google.com/style/person) page, clarified guidance about when to use implicit *you*.
- On the [UI elements and interaction](https://developers.google.com/style/ui-elements) page, added guidance about *toggle*.
- Added entries to the [word list](https://developers.google.com/style/word-list): *dashboard*, *master*. Unrelatedly, fixed a longstanding word list typo.

## April 27, 2020

- On the [Documenting command-line syntax](https://developers.google.com/style/code-syntax) page, added guidance about showing the output of commands.
- On the [Example domains and names](https://developers.google.com/style/examples) page, added example IPv6 addresses.
- On the [Words as words](https://developers.google.com/style/words-as-words) page, clarified guidance.
- In the [word list](https://developers.google.com/style/word-list), clarified guidance for the word *following*. Also clarified guidance for the various *console* terms.
- Added an entry to the [word list](https://developers.google.com/style/word-list): *native*.

## April 20, 2020

- On the [Units of measurement](https://developers.google.com/style/units-of-measure) page, added guidance about using *per* when referring to rates.
- On the [UI elements and interaction](https://developers.google.com/style/ui-elements) page, clarified the distinction between text input and keyboard shortcuts, and added guidance about when to use the `code` and `kbd` elements. On the [Code in
  text](https://developers.google.com/style/code-in-text) page, added text input to the list of things to put in code font.
- On the [Accessible content](https://developers.google.com/style/accessibility) page, added a recommendation to use a screen reader to test your documentation. Also added guidance about introducing tables.
- On the [Example domains and names](https://developers.google.com/style/examples) page, changed the recommended example company names to avoid camel case.
- On the [Code in text](https://developers.google.com/style/code-in-text) page and the [Colons](https://developers.google.com/style/colons) page, clarified and expanded guidance about how to format a colon after text that's bold or in code font.
- Added entries to the [word list](https://developers.google.com/style/word-list): *key*, *key ring*, *per*, *vice versa*.

## April 13, 2020

- On the [Lists](https://developers.google.com/style/lists) page, expanded the guidance about when not to use sentence-ending punctuation.
- Added cross-references between the [Abbreviations](https://developers.google.com/style/abbreviations) page and the [Headings and titles](https://developers.google.com/style/headings) page.
- On the [Numbers](https://developers.google.com/style/numbers) page, clarified the guidance about hyphens and en dashes in ranges of numbers.
- On the [Units of measure](https://developers.google.com/style/units-of-measure) page, clarified guidance about what counts as a unit.
- In the [word list](https://developers.google.com/style/word-list), clarified guidance about using *blacklist* and *whitelist*.
- Added entries to the [word list](https://developers.google.com/style/word-list): *ad tech*, *easily*, *fintech*, *NLU*, *quick*, *quickly*.

## April 6, 2020

- On the [Abbreviations](https://developers.google.com/style/abbreviations) page, clarified guidance about using abbreviations in headings and titles.
- On the [Text-formatting summary](https://developers.google.com/style/text-formatting) page, added guidance on formatting mathematical variables.
- On the [Link text](https://developers.google.com/style/link-text) page, added guidance about abbreviations in link text.
- On the [Dates and times](https://developers.google.com/style/dates-times) page, added guidance about how to express time zones.
- In the [word list](https://developers.google.com/style/word-list), clarified guidance about *key-value pair*.
- Added an entry to the [word list](https://developers.google.com/style/word-list): *personally identifiable information (PII)*.

## March 30, 2020

- On the [Hyphens](https://developers.google.com/style/hyphens) page, clarified guidance about ranges of numbers.
- In the [UI elements and interaction](https://developers.google.com/style/ui-elements) page, changed guidance for formatting input for text boxes to recommend using the HTML `code` element instead of the `kbd` element.

## March 23, 2020

- On the [Capitalization](https://developers.google.com/style/capitalization) page, made the following changes:
  - Removed outdated guidance about capitalization after a run-in heading. For the current guidance, see "Description lists that use run-in headings" on the [Lists](https://developers.google.com/style/lists) page.
  - Clarified guidance about avoiding all-uppercase and camel case.
  - Clarified guidance about avoiding lowercase at the start of a sentence.
  - Clarified guidance about capitalization when referring to documents by title in various contexts.
- Expanded and reorganized the [Code in
  text](https://developers.google.com/style/code-in-text) page. In particular:
  - Expanded the guidance about documenting placeholders.
  - Expanded the list of items to put in code font.
- On the [Commas](https://developers.google.com/style/commas) page, added guidance about using a comma with *because*.
- On the [Dashes](https://developers.google.com/style/dashes) page, added guidance about not using en dashes.
- Added entries to the [word list](https://developers.google.com/style/word-list): *datastore*, *tutorial*. Also added guidance (in the entry for *documentation*) about phrases like *in this document*.

## March 2, 2020

- On the [Capitalization](https://developers.google.com/style/capitalization) page, added guidance about using sentence case for labels and callouts.
- On the [Cross-references](https://developers.google.com/style/cross-references) page, added guidance about how to format the titles of web series.
- Added an entry to the [word list](https://developers.google.com/style/word-list): *web server*.

## February 24, 2020

- On the [Resources](https://developers.google.com/style/resources) page, added links to the Kubernetes glossary and the Kubernetes style guide.
- On the [Lists](https://developers.google.com/style/lists) page, added guidance about how and when to use a bulleted list with run-in headings.
- Updated the [word list](https://developers.google.com/style/word-list) to refer to *Google Cloud* instead of *GCP*, in accord with a recent name change. In particular, changed entries for *GCP*, *GCP Console*, and *GCP project ID* to *Google Cloud*, *Google Cloud Console*, and *Google Cloud project ID*, respectively.
- Added an entry to the [word list](https://developers.google.com/style/word-list): *GKE node*. Also updated guidance for *GKE*.
- In the left nav, moved the word list and the product-names page to near the top.
- On the [Plurals in parentheses](https://developers.google.com/style/plurals-parentheses) page, added guidance about using the phrase *one or more*.

## January 13, 2020

- In the [Writing for a global audience](https://developers.google.com/style/translation) page, fixed a broken link.
- In the [Code in text](https://developers.google.com/style/code-in-text) page, added *environment variable names* to the list of items to put in code font.
- Added entries to the [word list](https://developers.google.com/style/word-list): *A/B testing*, *BGP*.

## January 6, 2020

- Added entries to the [word list](https://developers.google.com/style/word-list): *DevOps*, *ECMP*, *GFE*, *NoSQL*, *PostgreSQL*. Also updated guidance on *virtual machine (VM) instance*.

## December 23, 2019

- Expanded and clarified the [Writing for a
  global audience](https://developers.google.com/style/translation) page.
- Renamed the "Typographical conventions" page to "[Text-formatting summary](https://developers.google.com/style/text-formatting)."
- On the [Tables](https://developers.google.com/style/tables) page, clarified guidance about punctuation in table column heads.
- On the [Filenames and file types](https://developers.google.com/style/filenames) page, added *.jar* to the list of filename extensions.
- On the [UI elements](https://developers.google.com/style/ui-elements) page and the word list, clarified guidance about when to use *box* and *field* to refer to text boxes.

## December 16, 2019

- On the [Abbreviations](https://developers.google.com/style/abbreviations) page, expanded guidance about when to spell out abbreviations.
- On the [conventions page](https://developers.google.com/style/typographical-conventions), fixed two broken links.
- Added entries to the [word list](https://developers.google.com/style/word-list): *as*, *big-endian*, *google.dev*, *little-endian*.

## December 9, 2019

- On the [Tables](https://developers.google.com/style/tables) page, added guidance about sorting tables, and clarified guidance about when to use tables.
- Reverted last week's changes about using *earlier* and *later* instead of *lower* and *higher*; those changes need further refining.

## December 2, 2019

- On the [Cross-references](https://developers.google.com/style/cross-references) page, added guidance about using the word *about* in cross-references, rather than *on*.
- Added entries to the [word list](https://developers.google.com/style/word-list): *about versus on*, *for instance*, *SLA*. Also changed guidance about using *earlier* and *later* for a range of version numbers.

## November 25, 2019

- On the [UI elements and interaction](https://developers.google.com/style/ui-elements) page, added guidance about focusing on the task rather than on UI elements as such.
- On various pages, added cross-references linking to other pages.

## November 18, 2019

- Added a new [Typographic
  conventions](https://developers.google.com/style/typographical-conventions) page.
- Reorganized the [Units of
  measurement](https://developers.google.com/style/units-of-measure) page. Also added guidance about Kelvin temperatures.
- On the [Cross-references](https://developers.google.com/style/cross-references) page, clarified guidance about cross-references that aren't links.
- On the [UI elements and interaction](https://developers.google.com/style/ui-elements) page, added information about expander arrows.
- Added a term to the [word list](https://developers.google.com/style/word-list): *slice and dice*.

## November 11, 2019

- On the [Figures and other images](https://developers.google.com/style/images) page, clarified guidance about figure descriptions.
- On the [Units of measurement](https://developers.google.com/style/units-of-measure) page, added guidance about ranges of numbers.
- On the [Product names](https://developers.google.com/style/product-names) page, clarified guidance about using full trademarked product names.
- Added terms to the [word list](https://developers.google.com/style/word-list): *billing charges*, *port*, *repo*, *UI*.

## October 28, 2019

- Added guidance about what to do if there's [more than one way to complete a
  task](https://developers.google.com/style/procedures#same-task).
- Added terms to the [word list](https://developers.google.com/style/word-list): *just*, *multi-tenancy*.

## October 21, 2019

- Added a page about [formatting
  words as words](https://developers.google.com/style/formatting-words-as-words).
- Added a page about [formatting key
  terms](https://developers.google.com/style/formatting-key-terms).
- Changed the guidance about how to capitalize a [UI element](https://developers.google.com/style/ui-elements) name when the label is all-uppercase in the UI.
- Added guidance about [explaining
  placeholders](https://developers.google.com/style/code-in-text#explain-placeholders).
- Updated the list of [items to put in
  code font](https://developers.google.com/style/code-in-text#code).
- Clarified the guidance about using official [capitalization](https://developers.google.com/style/capitalization) for names of products.
- Changed the title of the [style guide landing
  page](https://developers.google.com/style).
- Deleted the page about URLs in links, and moved the material that was on that page to the [cross-references](https://developers.google.com/style/cross-references) page. Also added some examples to that page.
- Removed unnecessary explanations of the icons that indicate that a guideline applies only in Android documentation or only in Google Cloud Platform documentation.
- Added examples to the [footnotes](https://developers.google.com/style/footnotes) page.
- Improved a link on the [Accessible
  content](https://developers.google.com/style/accessibility) page.
- Added terms to the [word list](https://developers.google.com/style/word-list): *BMaaS*, *US*.

## October 8, 2019

- Reorganized the page about [notices](https://developers.google.com/style/notices), and added examples.
- Cleaned up some minor formatting and phrasing issues in the [word list](https://developers.google.com/style/word-list).
- Corrected a typo on the [Accessible
  content](https://developers.google.com/style/accessibility) page.
- Changed the title of the style guide to use sentence case.

## September 30, 2019

- Added a term to the [word list](https://developers.google.com/style/word-list): *PoP*.

## September 23, 2019

- Added a page about [footnotes](https://developers.google.com/style/footnotes).
- Reorganized the [Other editorial resources](https://developers.google.com/style/resources) page.

## September 16, 2019

- Added a page about [using material from
  other sources](https://developers.google.com/style/other-sources).
- Added guidance about [using
  *a* and *an* with product names](https://developers.google.com/style/product-names#shortening).
- Removed contradictory guidance about quotation marks with [link text](https://developers.google.com/style/link-text).
- Clarified guidance about [periods
  with abbreviations](https://developers.google.com/style/abbreviations#periods).
- Clarified guidance about [capitalization
  following a colon](https://developers.google.com/style/capitalization).
- Moved the list of UI-related verbs from the UI elements page to the [word list](https://developers.google.com/style/word-list).
- Also added other terms to the [word list](https://developers.google.com/style/word-list): *cons*, *Gbps*, *Kbps*, *Mbps*, *pros*. Also updated the entry for *service*.

## June 24, 2019

- Added guidance about US currency to the [Numbers](https://developers.google.com/style/numbers) page.

## June 17, 2019

- Added further guidance about accessibility to the [Accessible content](https://developers.google.com/style/accessibility) page and other related pages.
- Added guidance about graphically violent terms to the [Writing inclusive documentation](https://developers.google.com/style/inclusive-documentation) page.
- Added guidance about the term *wheelchair-bound* to the [Writing inclusive documentation](https://developers.google.com/style/inclusive-documentation) page.
- Added guidance about currency to the [Units of measure](https://developers.google.com/style/units-of-measure) page.
- Added an example showing how to [use
  Markdown to mark up images](https://developers.google.com/style/images).
- Added terms to the [word list](https://developers.google.com/style/word-list): *disclosure triangle*, *hamburger menu*, *kebab menu*, *outpost*, *STONITH*. Also expanded guidance about *should*.

## May 20, 2019

- Added a new page about [avoiding excessive claims](https://developers.google.com/style/excessive-claims).
- Added material about file types to the [Filenames and file types](https://developers.google.com/style/filenames) page.
- Added terms to the [word list](https://developers.google.com/style/word-list): *CSV*, *traditional*, *YAML*.

## April 29, 2019

- Replaced the guidelines on the [Accessible content](https://developers.google.com/style/accessibility) page with a new set of more relevant guidelines.
- Added a term to the [word list](https://developers.google.com/style/word-list): *execute*.
- Added material about Linux signals on the [Command-line terminology](https://developers.google.com/style/command-line-terminology) page, and updated related entries in the word list.

## April 22, 2019

- Added a term to the [word list](https://developers.google.com/style/word-list): *method*. Also added to the guidance for *Cloud*.

## April 15, 2019

- Added more guidance about digit-group separators on the [Numbers](https://developers.google.com/style/numbers) page.
- Fixed a broken link on the [Numbers](https://developers.google.com/style/numbers) page, and another on the [Writing for a global
  audience](https://developers.google.com/style/translation) page.
- Updated guidance about example names on the [Example domains and names](https://developers.google.com/style/examples) page.
- Added guidance about removing personally identifying information from screenshots on the [Figures and other images](https://developers.google.com/style/images) page.
- Added guidance about using code font for names of command-line utilities on the [Code in text](https://developers.google.com/style/code-in-text) page.
- Added guidance about short and long versions of words like *app* and *demo* on the [Abbreviations](https://developers.google.com/style/abbreviations) page.

## March 4, 2019

- Clarified guidance about person-first and identity-first language on the [Writing inclusive documentation](https://developers.google.com/style/inclusive-documentation) page.
- Added guidance about passive voice on the [Active voice](https://developers.google.com/style/voice) page.
- Added more guidance about links on the [Linking to other sites](https://developers.google.com/style/links-external) page.
- Added terms to the [word list](https://developers.google.com/style/word-list): *guru*, *spin up*. Also revised the guidance for *Container Engine*.

## February 25, 2019

- Added extensive new material to the [inclusive documentation](https://developers.google.com/style/inclusive-documentation) page.
- Updated the [word list](https://developers.google.com/style/word-list):
  - Clarified guidance for *argument* and *flag*.
  - Added terms: *allows you to*, *desire*, *drop-down*, *wish*.
  - Removed the recommendations against using *enable* and *disable*, and clarified guidance for those terms.

## February 4, 2019

- Added terms to the [word list](https://developers.google.com/style/word-list): *add-in*, *add-on*.
- Added guidelines about avoiding [repetitive procedures](https://developers.google.com/style/procedures#repetitive-procedures).

## January 28, 2019

- Updated the [word list](https://developers.google.com/style/word-list):
  - Changed guidance for *above* and *below*.
  - Added terms: *gcloud*, *ML*.
  - Updated guidance for *\&*.
  - Improved alphabetization.
- Fixed a broken link in the [Lists](https://developers.google.com/style/lists) page.

## January 14, 2019

- Added terms to the [word list](https://developers.google.com/style/word-list): *comprise*, *console*, *fail over*, *GCP Console*, *Google Cloud Platform Console*, *populate*, *surface*.
- Reorganized the [UI elements](https://developers.google.com/style/ui-elements) page, and added guidance and examples.
- Added Markdown information to the [URLs for
  images](https://developers.google.com/style/img-elements) page.
- Clarified guidance about end punctuation for lists on the [Periods](https://developers.google.com/style/periods) page.
- Clarified guidance about nonbreaking spaces in the [Units of measurement](https://developers.google.com/style/units-of-measure) page.

## December 3, 2018

- Added a term to the [word list](https://developers.google.com/style/word-list): *lifetime*.
- Elaborated on our guidance in the [Closed compounds and prefixes](https://developers.google.com/style/word-list#compounds) section of the word list.
- Added a new page about [command-line terminology](https://developers.google.com/style/command-line-terminology) for gcloud and Linux.
- Added a section on [straight and
  curly quotation marks](https://developers.google.com/style/quotation-marks#straight-and-curly-quotation-marks) to the Quotation marks page.
- Added guidance about avoiding overuse of bolding to the [Procedures](https://developers.google.com/style/procedures) page.
- Added guidance about the phrases *hold the pointer over* and *point to* to the [UI elements and
  interaction](https://developers.google.com/style/ui-elements) page.

## October 29, 2018

- Added terms to the [word list](https://developers.google.com/style/word-list): *blacklist*, *whitelist*.
- Reorganized the [dates and times](https://developers.google.com/style/dates-times) page, and added guidance about times and about ISO 8601.

## October 8, 2018

- Added recommendations for [example company names](https://developers.google.com/style/examples#example-company-names).
- Added guidance about using monospace formatting to the [UI elements and interaction](https://developers.google.com/style/ui-elements) page.
- Added guidance about giving the location of an action in a procedure to the [Procedures](https://developers.google.com/style/procedures) page.

## September 18, 2018

- Added terms to the [word list](https://developers.google.com/style/word-list): *GKE*, *POJO*.

## September 4, 2018

- Added guidance about cases where [filenames aren't under your
  control](https://developers.google.com/style/filenames#other-exceptions).
- Added a term to the [word list](https://developers.google.com/style/word-list): *big data*.

## August 13, 2018

- Added guidance about [avoiding internet slang](https://developers.google.com/style/abbreviations#dont-use).
- Added terms to the [word list](https://developers.google.com/style/word-list): *multi-cloud*, *RTFM*, *tl;dr*, *ymmv*.

## July 30, 2018

- Added terms to the [word list](https://developers.google.com/style/word-list): *disaster recovery*, *file system*, *high availability*, *high performance computing*, *OS*, *tarball*, *tar file*.
- Updated guidance in the word list for *on-premises*.
- Rephrased a paragraph of the [landing page](https://developers.google.com/style).

## June 25, 2018

- Added terms to the [word list](https://developers.google.com/style/word-list): *IP*, *SAP*.

## June 19, 2018

- Added a term to the [word list](https://developers.google.com/style/word-list): *trojan*.
- Improved the organization, formatting, and phrasing of the [filenames page](https://developers.google.com/style/file-names).

## June 12, 2018

- Added terms to the [word list](https://developers.google.com/style/word-list): *appendix*, *index*, *matrix*.

## May 21, 2018

- Changed the guidance about [how to link to Android
  reference documentation](https://developers.google.com/style/code-in-text#linking-api-terms-in-android).
- Added information about [using *the* with
  product names](https://developers.google.com/style/product-names#using-the-with-product-names).
- Added a note about indefinite and casual numbers to the [Numbers](https://developers.google.com/style/numbers) page.
- Fixed a broken link on the [authorial tone](https://developers.google.com/style/tone) page.

## May 14, 2018

- Added terms to the [word list](https://developers.google.com/style/word-list): *multi-cluster*, *via*. Clarified guidance on *firewalls*.

## April 2, 2018

- Added a page about [writing inclusive documentation](https://developers.google.com/style/inclusive-documentation).
- Added terms to the [word list](https://developers.google.com/style/word-list): *at scale*, *IAM*, *RFC*.

## March 26, 2018

- Added information about [`alt` text for
  decorative images](https://developers.google.com/style/images#text-associated-with-images) to the images page.
- Added terms to the [word list](https://developers.google.com/style/word-list): *fill in*, *fill out*, *microservices*.

## February 26, 2018

- Added a term to the [word list](https://developers.google.com/style/word-list): *ad hoc*.

## February 12, 2018

- Added terms to the [word list](https://developers.google.com/style/word-list): *Cloud*, *Container Engine*, *ephemeral external IP address*, *firewalls*, *GCP*, *GCP project ID*, *internal IP address*, *NAT*, *network IP address*, *non-key*, *on-premises*, *persistent disk*, *project*, *RDP*, *static external IP address*, *subnet*, *table name*, *textbox*, *turn on*.
- Added information about closed compounds and prefixes to the [word list](https://developers.google.com/style/word-list#compounds).

## January 29, 2018

- Added terms to the [word list](https://developers.google.com/style/word-list): *alpha*, *autohealing*, *autoscaling*, *autotagging*, *bare metal*, *beta*, *CLI*, *Cloud SDK*, *colocate*, *CPU*, *curated roles*, *data center campus*, *data cleaning*, *data source*, *ETL*, *IaaS*, *impact*, *ingest*, *k8s*, *key pair*, *PaaS*, *preemptible*, *regex*, *SaaS*, *screenshot*, *sign-in*, *sign into*, *sign-out*, *sub-command*, *v*, *virtual machine instance*.
- Added a section on placeholder variables to the [code in text](https://developers.google.com/style/code-in-text#placeholder-variables) page.

## January 8, 2018

- Added terms to the [word list](https://developers.google.com/style/word-list): *argument*, *backup*, *dataflow*, *flag*, *higher*, *later*, *long press*, *multi-region*, *option*, *slave*, *touch \& hold*, *transpile*, *wildcard*.
- Added an item (DNS record types) to the list of [items to put
  in code font](https://developers.google.com/style/code-in-text#some-specific-items-to-put-in-code-font).

## December 11, 2017

- Added material on [numerical
  dimensions](https://developers.google.com/style/numbers#dimensions).
- Added material about [possessives of
  company and product names](https://developers.google.com/style/possessives#company--and-product-name-possessives).
- Added terms to the [word list](https://developers.google.com/style/word-list): *docset*, *documentation*, *startup*, *sync*.

## November 13, 2017

- Changed guidelines on [end punctuation for
  list items](https://developers.google.com/style/lists#capitalization-and-end-punctuation).
- Added alphabetical headings to the [word
  list](https://developers.google.com/style/word-list), so you can now jump to a specific letter using the in-page TOC.
- Updated [word list](https://developers.google.com/style/word-list) entries for *error-prone*, *real time*, and *Search*.
- Added terms to the [word list](https://developers.google.com/style/word-list): *dataset*, *legacy*, *nonfatal*.

## October 23, 2017

- Added a new page about [plurals in
  parentheses](https://developers.google.com/style/plurals-parentheses).
- Added a link to the C++ coding style guide, in the [Code style guides](https://developers.google.com/style/code-samples#coding) section.

## September 4, 2017

- Added several more terms to the [word list](https://developers.google.com/style/word-list): *check*, *checkbox*, *clear*, *deselect*, *open source*, *select*, *target*, *uncheck*, *Unix-like*, *unselect*.
- Added material to the [Trademarks](https://developers.google.com/style/trademarks) page about using trademarks as adjectives. Also added links to a couple of other trademark-related pages from Google.
- Removed Android-specific material from the [Headings](https://developers.google.com/style/headings) page, to bring Android doc guidelines more into line with non-Android guidelines. Also, added notes about things not to include in headings.
- Removed Android label from material on the [Tables](https://developers.google.com/style/tables) page, to make that material also apply to non-Android docs.
- Added mention of degrees and percents to the [Units of measurement](https://developers.google.com/style/units-of-measure) page.

## August 28, 2017

- Added 160+ terms to the [word list](https://developers.google.com/style/word-list). (Too many to list here.)
- Added recommendations for image size and placement to the [Images](https://developers.google.com/style/images) page.
- Moved material about Javadoc links to the [Code in text](https://developers.google.com/style/code-in-text) page.

## August 21, 2017

- Added new [File names](https://developers.google.com/style/file-names) page.
- Added new [Units of measurement](https://developers.google.com/style/units-of-measure) page.
- Changed "[internet](https://developers.google.com/style/word-list#internet)" to lowercase.
- Added material about line lengths and Javadoc-style links to the [HTML formatting](https://developers.google.com/style/html-formatting) page.

## July 31, 2017

- Added new [Headings and titles](https://developers.google.com/style/headings) page, mostly focused on Android documentation.
- Added information about [tables in Android docs](https://developers.google.com/style/tables#a-few-more-notes-about-tables) to the Tables page.

## July 10, 2017

- Added words to the [word list](https://developers.google.com/style/word-list): *deep linking*, *jank*, *wake lock*.

## June 8, 2017

- Public release.