This repository houses the Doom Emacs community discussions board, project resources (like development roadmap issues and the Do-Not-PR list), and documentation about the project community's structure, social platforms, and policies.
For a comprehensive list of resources, visit the project's home page.
Important
If you come across a Doom Emacs community in the wild, please encourage them to label themselves as unofficial, and to link to this repository so users know where to find answers for their issues.
When creating a new post, try your best to select the best category to post in. This ensures others quickly find answers to their questions as well as the questions they may be able to answer. Plus some categories have templates that prompt you for important information we need to diagnose your issues, without which your post may be deleted or responses to your issue could be significantly delayed.
- 📣 Announcements — where we post releases, important events, breaking changes, and status updates (which get mirrored to our socials).
- 💭 General — for discussions that don't fit in any other category. Say hi, share your experiences, meet fellow Doom users — just don't use this space to ask for help!
- 💡 Ideas — for RFCs and feature requests, or discussing new modules, documentation, or other content before any actual work is done. Once an idea is approved, it is moved to that particular project's sub-category.
- 🆘 Issues — a staging ground for potential bug reports. Not sure if your issue is Doom's responsibility to fix? Not sure which repository your issue should be posted to? Post here instead.
- ❓ Questions — ask the community for help using, configuring or extending Doom Emacs. Or ask about the project's design, author, or future. Just don't use this space for resolving errors or bugs!
- Projects — these sub-categories exist for contributors and maintainers to
discuss active development efforts, track approved RFCs, and deliver
occasional updates about them. Use the other categories if you want to propose
new ideas, ask user support questions, or bug reports (unless they are
regressions from recent development efforts discussed there):
- 👥 Community
- 🛠️ Core
- ➕ Modules
- 🔗 Websites
There are no plans to adopt any new platforms. It's enough effort managing what we have.
If you have ruled out personal configuration and upstream bugs (from Emacs or packages), are able to reproduce the issue on a stable version of Emacs, and can identify which repository it belongs in, then report your issue to it's Github issue tracker.
If you're uncertain about any part of your issue, then post it to the Issues
category of our Discussion board or discuss it with us on our
Discord server (in the #doom-help channel).
Don't forget to include your M-x doom/info and any steps to reproduce the
issue!
That's personal preference. Choose the option you're more comfortable with.
Discord tends to be more relaxed. Github Discussions are more visible (and google-able).
Warning
Choose one! Please don't post to both unless you haven't gotten a response in weeks!
If your matter is sensitive (e.g. concerns personal data, ban appeals, issues with our moderators, or other private matters), email the project's maintainer at support@doomemacs.org.
Otherwise, drop us a line on our Github Discussion board or our Discord server.