What's new

Each week, we update this page with a summary of recent significant changes to the style guide. If there haven't been any significant changes in a given week, we don't publish an update.

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
New entry: time to live Word list

November 23, 2020

New guidance or change Page
Changed guidance about fictitious email addresses. Example domains and names
New entry: holiday, the holidays Word list

November 16, 2020

New guidance or change Page
In examples, use fictional street addresses. Example domains and names
Clarified guidance for functionality. Word list

November 9, 2020

New guidance or change Page
Format folder and directory names in code font. Code in text

November 2, 2020

New guidance or change Page
Avoid double negatives. Writing accessible documentation
Expanded guidance about how to write around unavoidable references to non-inclusive words. Writing 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

October 12, 2020

New guidance or change Page
Use enable or turn on consistently. Word list
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
For subsections, use the phrase in the following sections. Headings and titles
Don't create your own abbreviations. Abbreviations
Don't reveal personally identifiable information. Example domains and names
For exponents, use standard mathematical notation. Numbers
Expanded guidance about expressing times of day. Dates and times
New entries: aka, America, -aware, Black Friday, Cyber Monday, leverage, possible, postmortem Word list

October 5, 2020

  • In the word list, updated guidance about the term disable.

September 28, 2020

  • On the Capitalization page, expanded guidance about using consistent capitalization.
  • On the Procedures page, added guidance about including keyboard shortcuts in procedures.

September 21, 2020

  • On the Figures and other images page, added guidance about using image maps.
  • On the Text-formatting summary 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: distributed denial-of-service (DDoS), UTF.

September 14, 2020

  • On the Figures and other images page and the Tables page, added guidance about introductory sentences.
  • In the 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

August 31, 2020

August 24, 2020

August 10, 2020

August 3, 2020

  • On the Dates and times page, added guidance about avoiding referring to seasons of the year.
  • In the word list, added more suggested alternatives for master and slave.

July 27, 2020

  • Added entries to the 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 page, and moved that page to near the top of the left nav.
  • On the Figures and other images page, added links to Web Content Accessibility Guidelines (WCAG) resources.
  • On the Procedures page, added guidance about introducing a procedure with an imperative.
  • Added entries to the 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 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 page, and deleted the separate command-line terminology page.
    • Moved the guidance about placeholders to a new Formatting placeholders page.
    • Added cross-references among various code-related pages.
  • In the word list, corrected a typo.

June 22, 2020

  • In the word list, changed guidance about using earlier and later for a range of version numbers.

June 15, 2020

  • On the Capitalization page and other pages, made guidance consistent about capitalizing references to document titles.
  • On the Cross-references page and other pages, added guidance about not forcing a link to open in a new tab.
  • On the Code in text page, added guidance about when to put UI elements in code font.
  • Added an entry to the word list: best effort.

June 8, 2020

June 1, 2020

  • On the Figures and other images page, updated guidance about alt text, figure descriptions, and figure captions.
  • Reorganized the HTML and semantic tagging page, and added guidance about not using the <br> element to change visual presentation. Also replaced a broken link to a third-party site.
  • On the Numbers page, added guidance about avoiding using Roman numerals.
  • Added entries to the word list: currently, dash, NoOps.

May 25, 2020

  • On the Numbers page, corrected two examples to match our guidance.
  • On the Abbreviations page, added guidance about use of the term acronym.
  • Added entries to the 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 page, added guidance about how to refer to a filename.
  • On the Headings and titles page, updated the guidance about using code font in headings.
  • On the UI elements and interaction page and elsewhere, replaced the term arrow notation with angle bracket.
  • On the Procedures page, clarified the guidance about stating the location of an action before stating the action.
  • Added entries to the 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 page, changed guidance for placeholder styling. The new preferred style is all-uppercase with underscore delimiters.
  • Also on the Code in text page, corrected guidance about how to mark up placeholders with Markdown.
  • On the Figures and other images page, corrected a typo.

May 4, 2020

April 27, 2020

April 20, 2020

  • On the Units of measurement page, added guidance about using per when referring to rates.
  • On the UI elements and interaction 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 page, added text input to the list of things to put in code font.
  • On the Accessible content 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 page, changed the recommended example company names to avoid camel case.
  • On the Code in text page and the 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: key, key ring, per, vice versa.

April 13, 2020

  • On the Lists page, expanded the guidance about when not to use sentence-ending punctuation.
  • Added cross-references between the Abbreviations page and the Headings and titles page.
  • On the Numbers page, clarified the guidance about hyphens and en dashes in ranges of numbers.
  • On the Units of measure page, clarified guidance about what counts as a unit.
  • In the word list, clarified guidance about using blacklist and whitelist.
  • Added entries to the word list: ad tech, easily, fintech, NLU, quick, quickly.

April 6, 2020

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

March 30, 2020

  • On the Hyphens page, clarified guidance about ranges of numbers.
  • In the UI elements and interaction page, changed guidance for formatting input for text boxes to recommend using the HTML <code> element instead of <kbd>.

March 23, 2020

  • On the 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 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 page. In particular:
    • Expanded the guidance about documenting placeholders.
    • Expanded the list of items to put in code font.
  • On the Commas page, added guidance about using a comma with because.
  • On the Dashes page, added guidance about not using en dashes.
  • Added entries to the word list: datastore, tutorial. Also added guidance (in the entry for documentation) about phrases like in this document.

March 2, 2020

  • On the Capitalization page, added guidance about using sentence case for labels and callouts.
  • On the Cross-references page, added guidance about how to format the titles of web series.
  • Added an entry to the word list: web server.

February 24, 2020

  • On the Resources page, added links to the Kubernetes glossary and the Kubernetes style guide.
  • On the Lists page, added guidance about how and when to use a bulleted list with run-in headings.
  • Updated the 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: 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 page, added guidance about using the phrase one or more.

January 13, 2020

January 6, 2020

  • Added entries to the word list: DevOps, ECMP, GFE, NoSQL, PostgreSQL. Also updated guidance on virtual machine (VM) instance.

December 23, 2019

December 16, 2019

  • On the Abbreviations page, expanded guidance about when to spell out abbreviations.
  • On the conventions page, fixed two broken links.
  • Added entries to the word list: as, big-endian, google.dev, little-endian.

December 9, 2019

  • On the 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 page, added guidance about using the word about in cross-references, rather than on.
  • Added entries to the 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 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

November 11, 2019

October 28, 2019

October 21, 2019

October 8, 2019

  • Reorganized the page about notices, and added examples.
  • Cleaned up some minor formatting and phrasing issues in the word list.
  • Corrected a typo on the Accessible content page.
  • Changed the title of the style guide to use sentence case.

September 30, 2019

September 23, 2019

September 16, 2019

June 24, 2019

  • Added guidance about US currency to the Numbers page.

June 17, 2019

May 20, 2019

April 29, 2019

  • Replaced the guidelines on the Accessible content page with a new set of more relevant guidelines.
  • Added a term to the word list: execute.
  • Added material about Linux signals on the Command-line terminology page, and updated related entries in the word list.

April 22, 2019

  • Added a term to the word list: method. Also added to the guidance for Cloud.

April 15, 2019

March 4, 2019

February 25, 2019

  • Added extensive new material to the inclusive documentation page.
  • Updated the 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

January 28, 2019

  • Updated the word list:
    • Changed guidance for above and below.
    • Added terms: gcloud, ML.
    • Updated guidance for &.
    • Improved alphabetization.
  • Fixed a broken link in the Lists page.

January 14, 2019

  • Added terms to the word list: comprise, console, fail over, GCP Console, Google Cloud Platform Console, populate, surface.
  • Reorganized the UI elements page, and added guidance and examples.
  • Added Markdown information to the URLs for images page.
  • Clarified guidance about end punctuation for lists on the Periods page.
  • Clarified guidance about nonbreaking spaces in the Units of measurement page.

December 3, 2018

October 29, 2018

  • Added terms to the word list: blacklist, whitelist.
  • Reorganized the dates and times page, and added guidance about times and about ISO 8601.

October 8, 2018

September 18, 2018

September 4, 2018

August 13, 2018

July 30, 2018

  • Added terms to the 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.

June 25, 2018

June 19, 2018

  • Added a term to the word list: trojan.
  • Improved the organization, formatting, and phrasing of the filenames page.

June 12, 2018

  • Added terms to the word list: appendix, index, matrix.

May 21, 2018

May 14, 2018

  • Added terms to the word list: multi-cluster, via. Clarified guidance on firewalls.

April 2, 2018

March 26, 2018

February 26, 2018

February 12, 2018

  • Added terms to the 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.

January 29, 2018

  • Added terms to the 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 page.

January 8, 2018

  • Added terms to the 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.

December 11, 2017

November 13, 2017

  • Changed guidelines on end punctuation for list items.
  • Added alphabetical headings to the word list, so you can now jump to a specific letter using the in-page TOC.
  • Updated word list entries for error-prone, real time, and Search.
  • Added terms to the word list: dataset, legacy, nonfatal.

October 23, 2017

September 4, 2017

  • Added several more terms to the word list: check, checkbox, clear, deselect, open source, select, target, uncheck, Unix-like, unselect.
  • Added material to the 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 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 page, to make that material also apply to non-Android docs.
  • Added mention of degrees and percents to the Units of measurement page.

August 28, 2017

  • Added 160+ terms to the word list. (Too many to list here.)
  • Added recommendations for image size and placement to the Images page.
  • Moved material about Javadoc links to the Code in text page.

August 21, 2017

July 31, 2017

July 10, 2017

  • Added words to the word list: deep linking, jank, wake lock.

June 8, 2017

  • Public release.