Skip to main content

Mention cards / users in cards' description

Learn more about how to link cards or mention users in the description of your cards.

Tamás Párványik avatar
Written by Tamás Párványik
Updated over 2 weeks ago

Contents:

Overview

Mentioning users or other cards in your user story descriptions enhances clarity, traceability, and collaboration. This is especially when communicating with stakeholders.

How to mention user(s) in card description

  1. Open a card on the story map

  2. Type @

  3. Select a user to be mentioned

How to link cards into cards description

  1. Open a card on the story map

  2. Type @

  3. Scroll down and select a card to be linked

Use cases and examples

  1. Referencing Related Features

    • Use Case: Show dependencies or relationships between features.

    • Example:
      ​"This feature supports the flow defined in [Card: User Registration Flow]."

    • Benefit: Helps stakeholders understand context and dependencies at a glance.
      ​

  2. Tagging Stakeholders or Team Members

    • Use Case: Direct feedback or questions to the right person.

    • Example:
      ​"Need input from @Sarah on compliance requirements before we proceed."

    • Benefit: Keeps conversations relevant and reduces the need for separate meetings or emails.

  3. Cross-Linking Technical Tasks

    • Use Case: Connect frontend and backend work.

    • Example:

      "API endpoint handled in [Card: Create Booking API]."

    • Benefit: Improves coordination between developers and ensures nothing is missed in handoffs.
      ​

  4. Highlighting Reuse

    • Use Case: Note when a component or logic is reused.

    • Example:

      "Same logic as in [Card: Password Reset Email], just adapted for activation."

    • Benefit: Speeds up implementation and encourages reuse, reducing development effort.
      ​

Learn more about:

Did this answer your question?