Release notes

Each week, we provide release notes on this page giving 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 release notes.

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,, 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 Accessibility 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.