|
| 1 | +--- |
| 2 | +authors: |
| 3 | + - Martin Stühmer |
| 4 | + |
| 5 | +applyTo: |
| 6 | + - "**/*" |
| 7 | + |
| 8 | +created: 2025-11-15 |
| 9 | + |
| 10 | +lastModified: 2025-11-15 |
| 11 | + |
| 12 | +state: accepted |
| 13 | + |
| 14 | +instructions: | |
| 15 | + GitHub Discussions is not used for team communication. Issues serve as the central point of contact for all project-related discussions and coordination. This decision reduces tool fragmentation and ensures all communication flows through a single, tracked channel. |
| 16 | +--- |
| 17 | + |
| 18 | +# Decision: No GitHub Discussions for Communication |
| 19 | + |
| 20 | +We do not use GitHub Discussions as a communication channel for this project. All team communication related to project decisions, issues, and coordination occurs through GitHub Issues. |
| 21 | + |
| 22 | +## Context |
| 23 | + |
| 24 | +The project needed to establish clear guidelines for where team communication should occur. GitHub provides multiple communication mechanisms including Discussions, Issues, and Pull Request comments. Without clear boundaries, communication can become fragmented across multiple channels, making it difficult to track decisions and maintain context. |
| 25 | + |
| 26 | +## Decision |
| 27 | + |
| 28 | +GitHub Discussions will not be used for project communication. GitHub Issues will serve as the central point of contact for all project-related discussions and coordination. |
| 29 | + |
| 30 | +## Consequences |
| 31 | + |
| 32 | +**Positive:** |
| 33 | +- Single source of truth for all project communication |
| 34 | +- Improved traceability and searchability of decisions |
| 35 | +- Reduced cognitive overhead from having fewer communication channels |
| 36 | +- Better integration with workflow automation tied to Issues |
| 37 | + |
| 38 | +**Negative:** |
| 39 | +- Requires discipline to redirect team members away from Discussions |
| 40 | +- May require additional effort to maintain Issues as the communication hub |
| 41 | +- Issues-only approach requires clear issue templates and categorization to prevent clutter |
| 42 | + |
| 43 | +## Alternatives Considered |
| 44 | + |
| 45 | +**Use GitHub Discussions as the primary communication channel:** |
| 46 | +- Rejected because Issues are already established as the central contact point |
| 47 | +- Would create fragmentation between Issues and Discussions, making it harder to track decisions |
| 48 | + |
| 49 | +**Use external communication tools (Slack, Teams, etc.) for discussions:** |
| 50 | +- Rejected as these tools are not being considered for this project |
| 51 | +- Communication must remain within the GitHub ecosystem to maintain traceability |
| 52 | + |
| 53 | +**Use both Issues and Discussions for different purposes:** |
| 54 | +- Rejected because maintaining two communication channels adds unnecessary complexity |
| 55 | +- Issues provide sufficient functionality for all communication needs |
| 56 | + |
| 57 | +## Related Decisions |
| 58 | + |
| 59 | +None at this time. |
0 commit comments