|
| 1 | +--- |
| 2 | +date: 2023-10-02 |
| 3 | +authors: [squidfunk, alexvoss] |
| 4 | +categories: |
| 5 | + - General |
| 6 | +--- |
| 7 | + |
| 8 | +# Sunsetting Gitter: Towards Efficient Community Engagement |
| 9 | + |
| 10 | +__As we're starting to build a team around Material for MkDocs, we've decided to |
| 11 | +sunset and archive our [Gitter] channel on October 13, 2023 in favor of |
| 12 | +[GitHub Discussions].__ |
| 13 | + |
| 14 | +As part of our efforts to improve the processes for maintaining Material for |
| 15 | +MkDocs and for supporting the community, we have reviewed the use of different |
| 16 | +communication channels. At the moment, both [Gitter] and [GitHub Discussions] |
| 17 | +allow to ask the community for support and to discuss ideas and issues. In the |
| 18 | +past weeks, we have begun to question whether this duplication is in the best |
| 19 | +interest of our project. This post explains the rationale behind our decision. |
| 20 | + |
| 21 | + [our sponsors]: ../../insiders/index.md#how-to-become-a-sponsor |
| 22 | + [Gitter]: https://gitter.im/squidfunk/mkdocs-material |
| 23 | + [GitHub discussions]: https://github.com/squidfunk/mkdocs-material/discussions |
| 24 | + |
| 25 | +<!-- more --> |
| 26 | + |
| 27 | +## The Constraints of Gitter |
| 28 | + |
| 29 | +In the first years of Material for MkDocs, [Gitter] served as a helpful platform |
| 30 | +for quick community interactions and questions. However, there are some inherent |
| 31 | +constraints that necessitated a shift. Here's a breakdown of the challenges we |
| 32 | +encountered: |
| 33 | + |
| 34 | +1. __Thread utilization__ – |
| 35 | + Even with the introduction of threads, many Gitter users were reticent to |
| 36 | + use them, leading to cluttered and disconnected conversations, making it |
| 37 | + difficult to follow. |
| 38 | + |
| 39 | +2. __Search and discovery__ – |
| 40 | + Gitter's structure and interface makes it cumbersome to search for and |
| 41 | + retrieve past messages, resulting in lost insights and repeated conversations. |
| 42 | + |
| 43 | +1. __User interface__ – |
| 44 | + After the acquisition by [Matrix], the user interface of Gitter has |
| 45 | + experienced a severe decline, becoming more complicated, less intuitive and |
| 46 | + user-friendly. |
| 47 | + |
| 48 | +1. __Access mandate__ – |
| 49 | + The necessity for users to grant access to their GitHub accounts to use |
| 50 | + Gitter posed an unnecessary access barrier and potential security concerns. |
| 51 | + |
| 52 | + [Matrix]: https://matrix.org/ |
| 53 | + |
| 54 | +## GitHub Discussions |
| 55 | + |
| 56 | +Thankfully, [GitHub Discussions] emerged and continues to evolve to be a much |
| 57 | +better alternative, eliminating many of Gitter's constraints and offering |
| 58 | +enhanced functionality: |
| 59 | + |
| 60 | +1. __Threaded conversations__ – |
| 61 | + GitHub Discussions supports structured, threaded conversations, ensuring |
| 62 | + discussions are coherent, contextual, and easy to follow for everyone. |
| 63 | + |
| 64 | +2. __Integration and linking__ – |
| 65 | + the platform facilitates seamless linking to other discussions, issues, code, |
| 66 | + and much more, enriching conversations and providing comprehensive context. |
| 67 | + |
| 68 | +3. __A unified platform__ – |
| 69 | + GitHub acts as a one-stop shop for support, allowing users to access varied |
| 70 | + resources and support channels in one place, greatly improving user |
| 71 | + experience. |
| 72 | + |
| 73 | +4. __Discoverability__ – |
| 74 | + GitHub Discussions are easily searchable and allow for categorization, |
| 75 | + preventing loss of valuable insights and fostering knowledge sharing. |
| 76 | + |
| 77 | +## Conclusion |
| 78 | + |
| 79 | +Sunsetting [Gitter] is a leap towards creating more efficient, user-friendly, |
| 80 | +and enriched community interactions. By consolidating communication to |
| 81 | +[GitHub Discussions], we seek to mitigate the fragmentation of information, |
| 82 | +ease the user journey, and fortify the bonds within our community. |
| 83 | + |
| 84 | +This concentrated approach enables us to provide consistent, fast and quality |
| 85 | +support to our users. In the past, the nature of queries raised on Gitter |
| 86 | +typically necessitated supplementary information or reproductions, prompting us |
| 87 | +to advise users to initiate a discussion subsequently. The shift to a |
| 88 | +centralized discussion forum is designed to simplify and accelerate this |
| 89 | +procedure, ensuring swift and efficient resolutions for our community. It is a |
| 90 | +testament to our ongoing commitment to support the community that helps Material |
| 91 | +for MkDocs flourish. |
| 92 | + |
| 93 | +We are confident that this streamlined approach will spur more |
| 94 | +fruitful discussions, innovative ideas, and collective growth, and we are |
| 95 | +excited to continue our journey with the unwavering support and active |
| 96 | +participation of our community. |
| 97 | + |
0 commit comments