↓ Skip to main content

Source: https://developers.google.com/style/spelling ↗\n\n# Word list

  Stay organized with collections



  Save and categorize content based on your preferences.\n\n- Home\n- Products\n- Style\n\n\n## Page Summary\n\n- This style guide promotes clear, concise, and inclusive language in technical documentation.\n- It provides specific word choices and formatting guidelines for Google Cloud and other technical content.\n- The guide discourages jargon, ambiguous language, and potentially offensive terms, prioritizing user understanding.\n- It offers preferred alternatives for various technical and general terms to ensure accuracy and consistency.\n- The guidelines aim to enhance clarity, accessibility, and inclusivity for a global audience.\n\nThis style guide promotes clear, concise, and inclusive language in technical documentation.\n\nIt provides specific word choices and formatting guidelines for Google Cloud and other technical content.\n\nThe guide discourages jargon, ambiguous language, and potentially offensive terms, prioritizing user understanding.\n\nIt offers preferred alternatives for various technical and general terms to ensure accuracy and consistency.\n\nThe guidelines aim to enhance clarity, accessibility, and inclusivity for a global audience.\n\nThis word list covers style and usage guidelines that are specific to developer documentation.\n\nIf the term that you're looking for isn't on this list, check our other

editorial resources, including our preferred dictionary, Merriam-Webster. If there are multiple spellings in the Merriam-Webster word entry, use the first form listed, which is the most common spelling. For example, in the entry for cancel, the first form listed for the past tense is canceled, indicating that it’s more common than cancelled.\n\nIf you’re looking for a technical definition, then it’s often a good idea to check the authoritative documentation on the topic.\n\nTerminology decisions, including how and when to define or contextualize terms, often require judgments based on factors like your product area, your audience, and prevailing convention. Here are some other pages of this guide that can help you make those types of judgments:\n\n- Jargon\n- Inclusive language\n- Write for a global audience\n- Hyphens\n- Capitalization\n\nAs always, it’s fine to deviate from our guidance if that serves your readers better. For more information, see Break the rules.\n\n\n## Word list\n\nAll word list entries have a link link icon next to them. To link directly to an entry, you can right-click and copy the link address, or click and copy the URL from your address bar.\n\nSome word list entries include guidance to avoid or don’t use a term. Apply this guidance as follows:\n\n- Use with caution. A recommendation to avoid using the term when possible, or to use the term with caution. The term might be ambiguous or obscure, so we provide alternative term suggestions or suggest that you use a more specific term. However, you can use the term if needed. Where appropriate, define the term or use it only once, as explained on the Jargon page.\n- Don’t use. In all cases, we prefer to not use the term. The term might be particularly ambiguous or it might have an offensive or non-inclusive association. If such a term appears in code, we recommend that you

replace or write around the term.\n- Android. Applies only to Android documentation.\n- Google Cloud. Applies only to Google Cloud documentation.\n- Google Workspace. Applies only to Google Workspace documentation.\n\n\n### Numbers and Symbols\n\n\n### A\n\nIn general, use the word authenticated only to refer to users,
    and use authorized only to refer to requests that are sent by a
    client app on behalf of an authenticated user.\n\nA user authenticates their identity by entering their password
    (or giving some other proof of identity). The authenticated
    user then authorizes the client app to send an
    authorized request to the server on the user's behalf.\n\n\n### B\n\n- For monitoring, use synthetic monitoring.\n- For testing, use opaque-box testing.\n\n- For the noun blacklist, consider using a replacement such as
      denylist, excludelist, or blocklist.\n- For the noun whitelist, consider using a replacement such as
      allowlist, trustlist, or safelist.\n- For the noun graylist (greylist), consider using a
      replacement such as provisional list.\n\n- To describe a general emergency or procedure that grants emergency
      access, use emergency access.\n- To describe a fallback procedure, use manual fallback or
      preplanned procedure.\n\n\n### C\n\nUse can in the following ways:\n\n- To convey permission or ability (for example, "You can access the
      server").\n- To refer to an optional action (for example, "You can also view
      logs with the Log Viewer").\n- To describe a possible outcome (for example, "The process can
      take 30 minutes").\n\n\n### D\n\nTo refer specifically to the text on a page that explains a product, feature, or service,
  use this document, and not this article, this topic, this doc, or
  this page. It's OK to use this tutorial, this quickstart, or this
  codelab for those specific documentation types.

Always spell out documentation except in cases where space is limited, such as in tabs and URLs. See also page.\n\nAlways spell out documentation except in cases where space is limited, such as in tabs and URLs. See also page.\n\nAlways spell out documentation except in cases where space is limited, such as in tabs and URLs.\n\nSee also page.\n\n\n### E\n\n- Use the same term in introductory text as described in the procedure.\n- Use the same term throughout the document unless there’s a difference in the UI elements for different procedures.\n\n\n### F\n\n\n### G\n\n\n### H\n\nOnly use this verb phrase in the following cases:\n\n- When the user needs to hold their mouse over a UI element, but not click the UI element. This action involves waiting for the UI to react—for example, waiting for a tooltip to open or waiting for a submenu to open.\n- When the duration of time is important.\n\nThe phrase point to is more common.\n\n\n### I\n\n- CDN Interconnect connection\n- Cloud Interconnect connection\n- Dedicated Interconnect connection\n- Partner Interconnect connection\n\nOK to use connection on subsequent mentions.\n\n\n### J\n\n\n### K\n\n\n### L\n\n\n### M\n\n\nDon’t use master in conjunction with slave in any context. | Cloud SQL primary/replica | Cloud SQL master/slave\nAvoid using master where possible. | GKE control plane Jenkins controller root key (in security) primary key (in databases) | GKE master plane Jenkins master master key (in security) master key (in databases)\n\n- GKE control plane\n- Jenkins controller\n- root key (in security)\n- primary key (in databases)\n\n- GKE master plane\n- Jenkins master\n- master key (in security)\n- master key (in databases)\n\n\n### N\n\nIn Android documentation, use higher instead of later.\n\n\n### O\n\n\n### P\n\nUse page to refer to the following:\n\n- A whole web page, which can include text, images, links, banners, navigational panes, and other features.\n- A sub-page of a console in particular.\n\nSee also documentation or document or documents.\n\n\n### Q\n\n\n### R\n\n\n### S\n\n\n### T\n\n\n### U\n\n\n### V\n\n\n### W\n\n- To decide whether it’s more appropriate to use if or whether, see Grammar Girl’s discussion of if and whether.\n- To decide whether you need to add or not when using whether, see the New York Times’s blog post about whether (or not).\n\n- For monitoring, use introspective monitoring. For testing, use clear-box testing.\n- For testing, use clear-box testing.\n\n\n### Y\n\n\n### Z\n