Skip to main content

Basic Collaboration Profile

Overview​

Collaborative discussions about architecture, design, and domain topics. Provides Discussion Thread elements.

Model elements​

IdNameDescription
collaboration.discussion-threadDiscussion ThreadA collaborative discussion thread about architecture, design, or domain topics

Relationships​

IdNameDescription
collaboration.discussesdiscussesIndicates that a discussion thread discusses a specific element
collaboration.related-torelated toIndicates a general relationship between discussion threads

Usage​

  1. Create Discussion Thread: Create a Discussion Thread element for a topic
  2. Set Properties: Define the topic, category, and context
  3. Link to Elements: Use "discusses" relationships to link to relevant elements
  4. Capture Key Questions: Document the questions or points being discussed
  5. Update Status: Change status as the discussion progresses
  6. Document Outcome: When resolved, document the conclusion or decision
  7. Link Related Discussions: Use "related-to" to connect related discussions

Best Practices​

  • Use Discussion Threads for exploration and debate
  • Link discussions to the elements they're about
  • Document the outcome when discussions are resolved
  • Archive discussions that are no longer relevant
  • Use clear, descriptive topics and categories
  • Capture key questions to help participants understand what needs to be addressed

Reference​

For the complete profile definition, see the basic-collaboration-profile-1.0.0.yaml file.