How to read this page#

Each entry gives the word, what it is, and the mistake people make about it. That last part is the useful one — definitions are easy, and misunderstandings are what generate support tickets.

Fill this in: replace the entries below with the real nouns from docs. Keep the shape — name, definition, common confusion — and keep the list under about ten items. A glossary nobody finishes is a glossary nobody reads.

The vocabulary#

Workspace — the boundary that separates one group's work from another's. Everything else lives inside one. Common confusion: people expect a workspace to behave like a folder. It is closer to an account, and moving things between workspaces is usually deliberate and occasionally impossible.

Project — a unit of work inside a workspace, with its own settings and history. Common confusion: a project looks like a good place to separate environments. Say whether it is intended that way before somebody splits production and staging across two.

Source — the place data comes from, together with the credential used to read it. Common confusion: deleting a source rarely deletes what was already imported. State plainly what disappears and what stays.

Member and role — who has access, and how much. Common confusion: role names sound like job titles, so people match them to the org chart instead of to the permissions. Write the permissions next to the name.

Naming things you create#

Two rules save a lot of cleanup later. Put the environment in the name, because "final" and "test" always survive longer than intended. And name things after what they are for rather than who made them — people leave, purposes stay.

Next steps#

• Your first five minutes — the words in use.
• Connect your data — sources, in practice.
• Troubleshooting — where these confusions cause problems.