Terminology Standards

To provide clarity to our users, use the standard terms in this section consistently within the documentation.

Service

Avoid using the term service. Research shows that different folks understand different things under that term. The following table shows acceptable alternatives that provide greater specificity and clarity to readers:

DoDon’t
Workload A sends a request to Workload B.Service A sends a request to Service B.
New workload instances start when …New service instances start when …
The application consists of two workloads.The service consists of two services.

Our glossary establishes the agreed-upon terminology, and provides definitions to avoid confusion.

Envoy

We prefer to use “Envoy” as it’s a more concrete term than “proxy” and resonates if used consistently throughout the docs.

Synonyms:

  • “Envoy sidecar” - ok
  • “Envoy proxy” - ok
  • “The Istio proxy” – best to avoid unless you’re talking about advanced scenarios where another proxy might be used.
  • “Sidecar” – mostly restricted to conceptual docs
  • “Proxy” – only if context is obvious

Related Terms:

  • Proxy agent - This is a minor infrastructural component and should only show up in low-level detail documentation. It is not a proper noun.

Miscellaneous

DoDon’t
addonadd-on
BookinfoBookInfo, bookinfo
certificatecert
colocateco-locate
configurationconfig
deletekill
Kuberneteskubernetes, k8s
load balancingload-balancing
Mixermixer
multiclustermulti-cluster
mutual TLSmtls
service meshService Mesh
sidecarside-car, Sidecar
Was this information useful?
Do you have any suggestions for improvement?

Thanks for your feedback!