Skip to content

Commit a126d9e

Browse files
committed
Added blog post on sunsetting Gitter
1 parent ddd125e commit a126d9e

File tree

2 files changed

+101
-0
lines changed

2 files changed

+101
-0
lines changed

docs/blog/.authors.yml

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -3,3 +3,7 @@ authors:
33
name: Martin Donath
44
description: Creator
55
avatar: https://avatars.githubusercontent.com/u/932156
6+
alexvoss:
7+
name: Alex Voss
8+
description: Community support
9+
avatar: https://avatars.githubusercontent.com/u/4134224
Lines changed: 97 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,97 @@
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

Comments
 (0)