Issues

An issue represents a topic or question that needs group input and decision-making.

Issues list in a project

Create an issue

1. Open your workspace

2. Click New Issue

3. Enter a clear, specific title

4. Add a description with context and background

5. Click Create

Create issue form

Issue lifecycle

Issues move through these stages:

1. Open - Active for discussion and motions

2. Voting - One or more motions are being voted on

3. Resolved - A decision has been reached

4. Closed - No longer active (can be reopened)

Open issue detail view

Resolved issue showing decision outcome

Best practices

Writing good issue titles

Good	Bad
"Should we adopt TypeScript for new projects?"	"TypeScript"
"Q2 budget allocation for marketing"	"Budget stuff"
"Choosing a new project management tool"	"Tools"

Providing context

Include in your description:

• Background on why this decision is needed

• Any constraints or requirements

• Relevant links or documents

• Timeline for when a decision is needed

Dashboard and action items

Your dashboard shows issues that need your attention:

• Assigned issues - Issues assigned to you

• @Mentions - Comments where someone mentioned you

• Pending votes - Motions waiting for your vote

The Action Items panel on the right side of your dashboard highlights urgent items requiring action.

Related

• Motions - How to propose solutions

• Voting - How decisions are made

• Comments - How to discuss issues and mention team members