docs: Add note for updated terminology (#11802)

# Which Problems Are Solved

For existing customers it could be hard to understand the new aligned
terms we have defined, if they are already used to the "old term"

# How the Problems Are Solved

Adding notes at the top of docs pages to state clearliy new and old
terms.
This commit is contained in:
Fabienne Bühler
2026-03-16 09:10:48 +00:00
committed by GitHub
parent cadf75e4fe
commit 9a4530bf77
15 changed files with 169 additions and 90 deletions
@@ -4,6 +4,11 @@ description: "Methods for retrieving assigned user roles and authorizations for
sidebar_label: Retrieve User Roles
---
<TerminologyUpdate
newTerm="Role Assignment"
oldTerms={["User Grant", "Authorization"]}
/>
This guide explains all the possible ways of retrieving user roles across different organizations and projects using ZITADEL's APIs.
## What are roles and role assignments in ZITADEL?
@@ -6,6 +6,11 @@ sidebar_label: Authenticate service accounts
import DocCardList from '@/components/docusaurus/doc-card-list';
<TerminologyUpdate
newTerm="Service Accounts"
oldTerms={["Service User", "Machine Users", "Technical Account"]}
/>
This guide explains ZITADEL service accounts and their role in facilitating secure machine-to-machine communication within your applications.
## What are Service Accounts?