5 Minute UX

Project Common Language and Glossary: What It Is and Why It Matters


Listen Later

You'll learn to define a project common language and glossary as a strategic alignment tool. By the end you'll be able to distinguish it from style guides and general documentation. This lesson gives you a framework for establishing shared vocabulary early in the project lifecycle to prevent stakeholder miscommunication.

Learning Objective: By the end of this lesson, learners will be able to define a project common language and glossary and distinguish it from other project artifacts.

Transcript
The Stakeholder Confusion Problem

There’s a specific moment in UX projects where effort vanishes, and it usually starts with a single word. Imagine a designer calls a wireframe a 'mockup,' but the client expects a high-fidelity visual, leading to wasted effort and frustration. Without shared definitions, diverse stakeholders like designers, developers, and subject matter experts interpret terms differently, creating friction. This misalignment creates a 'black hole of ideas' where stakeholder time and effort feel lost to the void. We need to stop this leak before it drains the project’s momentum and trust.

Key Points:

  • Scenario: A designer calls a wireframe a 'mockup,' but the client expects a high-fidelity visual, leading to wasted effort.

  • Problem: Without shared definitions, diverse stakeholders (designers, developers, SMEs) interpret terms differently.

  • Impact: Misalignment creates a 'black hole of ideas' where stakeholder time and effort feel lost.

  • Goal: Establish a 'common vocabulary for the deliverables' to ensure productive discussions.

  • Defining the Project Glossary

    By the end of this section, you'll be able to define a project common language and glossary, identifying its three core components: terms, roles, and deliverables. You'll learn to describe how this shared vocabulary solves stakeholder confusion and builds essential trust in your work.

    A project glossary is a documented set of definitions for specific terminology used throughout a UX project, grounding your team in a single source of truth. It includes clear explanations of project terms, roles, and the relationships between different deliverables or concepts, ensuring everyone sees the same structure. This is not merely a dictionary of words, but a strategic alignment artifact that defines the marching orders and approach for the team.

    When you establish this common vocabulary for deliverables, stakeholders understand exactly what type of output to expect at various stages of the project. This clarity prevents the black hole of ideas where effort feels lost, because everyone agrees on what a wireframe or prototype actually represents. It builds trust that their time and effort isn’t going into a void, but toward a well-defined set of marching orders.

    That foundational definition sets the stage for how we distinguish this artifact from style guides or general objectives in the next section.

    Key Points:

    • Definition: A documented set of definitions for specific terminology used throughout a UX project.

    • Components: Includes clear explanations of project terms, roles, and relationships between deliverables.

    • Purpose: It is a strategic alignment artifact, not merely a dictionary of words.

    • Outcome: Ensures everyone understands exactly what type of output to expect at various stages.

    • Recalling Alignment Challenges

      Think back to a project where the word prototype meant a clickable file to you but a rough sketch to the client. You likely felt that friction in early meetings when the lack of clarity on marching orders created unnecessary confusion. This happens because diverse stakeholders, including clients and subject matter experts, bring different professional vocabularies to the table. Without a shared language, their time and effort feel like they are going into a black hole of ideas.

      You already know that aligning on project goals is critical for success, but you must also align on the language used to discuss those goals. The source material emphasizes that a common language defines how the team communicates about objectives, not just what those objectives are. This distinction matters because conceptual consistency prevents the same misunderstandings from derailing your progress repeatedly.

      Experienced practitioners note that taking time at the start of meetings to define terms builds immediate trust. When you clarify the semantics of the project, you ensure that discussions remain productive and focused on actual work. The signal of strong alignment is a team that shares a common vocabulary for deliverables from day one.

      That shared vocabulary prevents confusion among diverse stakeholders, which sets the stage for distinguishing this artifact from other documents.

      Key Points:

      • Reflection: Think of a past project where a term like 'user story' or 'prototype' meant different things to different people.

      • Connection: Recall how lack of clarity on 'marching orders' or approach caused friction in early meetings.

      • Bridge: Just as you align on goals, you must align on the language used to discuss those goals.

      • Pre-training: Define 'stakeholder' broadly to include clients, subject matter experts, and internal teams.

      • Distinguishing Glossary from Other Artifacts

        The first move is to distinguish your glossary from other common project artifacts. It is easy to assume that any document containing definitions serves the same purpose, but experienced practitioners know that the function of the artifact determines its value in the workflow. You need to understand exactly what this tool does not do before you can leverage what it does do. This clarity prevents you from using the wrong instrument for the job at hand.

        Consider how project objectives differ from a common language glossary. Project objectives define what the project aims to achieve in terms of outcomes and goals. The glossary, however, defines how the team communicates about those objectives and the deliverables. One sets the destination, while the other sets the vocabulary for the journey. This distinction ensures that everyone is speaking the same language while working toward the same target.

        A glossary is also not a simple list of tasks or a checklist of activities. Task lists focus on actions and deadlines, whereas a glossary focuses on semantics and relationships between terms. It maps out the conceptual landscape rather than the chronological timeline of the work. This means you are aligning on meaning, not just managing a schedule of events.

        Another frequent confusion involves the difference between a glossary and a style guide. Style guides govern visual and tonal consistency across design elements and brand voice. A project glossary governs conceptual and terminological consistency among stakeholders and team members. One ensures the product looks right, while the other ensures the process is understood correctly. Both are essential, but they serve entirely different masters in the project ecosystem.

        This strategic alignment artifact belongs in the initial alignment and planning phases. You should establish this shared vocabulary before deep work begins on the design or development. Introducing it early prevents the black hole of ideas where stakeholder effort feels lost. It builds trust by clarifying deliverables and demystifying the design process for everyone involved.

        By applying the distinction between a project glossary and a style guide or general objectives, you protect your team from misalignment. You are creating a well-defined set of marching orders that everyone can reference. This proactive measure solidifies the foundation of the project work before complexity sets in. The result is a smoother collaboration where time and effort are directed effectively.

        Now that you understand what the glossary is not, the next section walks through how to apply the glossary strategy in your own projects.

        Key Points:

        • Vs. Project Objectives: Objectives define WHAT the project aims to achieve; glossary defines HOW the team communicates about them.

        • Vs. Style Guide: Style guides govern visual/tonal consistency; glossaries govern conceptual/terminological consistency.

        • Vs. Task Lists: A glossary is not a simple list of tasks but focuses on semantics and relationships between terms.

        • Timing: Establish this during the initial alignment and planning phases, before deep work begins.

        • Applying the Glossary Strategy

          In your next project, start by identifying key terms, roles, and deliverables that may be ambiguous to your specific stakeholders. Create a simple document or visual diagram defining these terms and illustrating their relationships. Share this glossary at the beginning of the project and revisit it in early meetings to ensure ongoing alignment and clarity. This practice builds trust by clarifying that stakeholder effort is directed toward clear, well-understood outputs. That brings the lesson full circle, back to the listener and the moment they'll first put the protocol into practice.

          Key Points:

          • Action: Identify key terms, roles, and deliverables that may be ambiguous to your specific stakeholders.

          • Creation: Create a simple document or visual diagram defining these terms and illustrating their relationships.

          • Implementation: Share this glossary at the beginning of the project and revisit it in early meetings.

          • Transfer: Use this tool to build trust by clarifying that stakeholder effort is directed toward clear, well-understood outputs.

          • ...more
            View all episodesView all episodes
            Download on the App Store

            5 Minute UXBy 5mUX