Skip to content

Commit e5d9b11

Browse files
Updated community support page.
1 parent 4eb2304 commit e5d9b11

File tree

1 file changed

+46
-9
lines changed

1 file changed

+46
-9
lines changed

docs/community.md

Lines changed: 46 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -1,18 +1,55 @@
11
# Community Support
22

3-
import TelegramLogoScreenshot from '/img/gitbook-import/assets/image (7) (1) (1).png';
4-
import GitterLogoScreenshot from '/img/gitbook-import/assets/image (38) (1) (1).png';
5-
import GitterChatScreenshot from '/img/gitbook-import/assets/image (37) (1) (1).png';
3+
The Avalonia community offers several ways to get help, share knowledge, and connect with other developers. Each platform serves a different purpose to help you get the most effective support for your needs.
64

7-
## Telegram
5+
## GitHub Discussions
86

9-
<img src={TelegramLogoScreenshot} alt="" />
7+
We encourage developers to ask questions on [GitHub Discussions](https://github.com/AvaloniaUI/Avalonia/discussions). This is our preferred platform for technical questions because:
108

11-
Access the Avalonia chat using the _Telegram_ app (recommended for the best experience).
9+
* Questions and answers are publicly searchable, helping future developers find solutions
10+
* Complex technical discussions can be properly formatted with code blocks
11+
* Issues can be easily linked to relevant pull requests or documentation
12+
* The community can build a knowledge base over time
1213

13-
:::info
14-
You can access the _Telegram_ chat [here](https://t.me/Avalonia).
15-
:::
14+
GitHub Discussions is ideal for:
1615

16+
* Implementation questions
17+
* Architecture discussions
18+
* Feature requests
19+
* General technical queries
1720

21+
## Community Chats
22+
23+
While our community chats are a fantastic resource for real-time discussion and quick help, it's important to understand their limitations. Chat platforms, by their nature, are where valuable information often gets lost to time. These conversations aren't indexed by search engines, can't be easily referenced later, and aren't accessible for AI learning systems that could help future developers. This means the same questions often get asked and answered repeatedly, reducing the efficiency of our community's knowledge sharing.
24+
25+
This is why we highly encourage using [GitHub Discussions](https://github.com/AvaloniaUI/Avalonia/discussions) as your first destination for questions. By posting on GitHub Discussions, you're not just getting help, you're contributing to a searchable, permanent knowledge base that benefits the entire Avalonia community and ecosystem.
26+
27+
### Telegram
28+
29+
Access the [Avalonia chat](https://t.me/Avalonia) using the [Telegram app](https://telegram.org/) (recommended for the best experience). Our Telegram community is great for:
30+
31+
* Quick questions specific to your application
32+
* Keeping up with community news and updates
33+
* Real-time troubleshooting
34+
* Networking with other Avalonia developers
35+
36+
You can access the Telegram chat [here](https://t.me/Avalonia).
37+
38+
### C# Discord
39+
40+
Some members of the Avalonia community can also be found in the [GUI channel on the C# Discord server](https://discord.com/channels/143867839282020352/169726357331378176). While this isn't an official Avalonia-specific channel, it can be a helpful resource for:
41+
42+
* General GUI development discussions
43+
* Cross-pollination of ideas with other .NET UI frameworks
44+
* Broader .NET ecosystem conversations
45+
46+
## Best Practices for Getting Help
47+
48+
To get the most effective help:
49+
50+
1. Use GitHub Discussions for general questions that could help others
51+
2. Use community chats for quick, specific questions about your implementation
52+
3. Always include relevant code examples and what you've tried
53+
4. Check the documentation and existing GitHub Discussions first
54+
5. Be specific about which version of Avalonia you're using
1855

0 commit comments

Comments
 (0)