Community discussions
On MDN Web Docs, we encourage our community to start and/or engage in discussions around topics related to the overall project. Discussions are categorized by different topic areas. We ask that you keep each discussion focused on the topic at hand instead of covering multiple topics in one discussion.
NOTE: mdn-community/discussions is not the place to report problems. For any problems you encounter on MDN Web Docs, it is best to raise issues against the relevant project. If you're ever in doubt about whether to open an issue or a discussion, consider the following guidelines:
- Issues are for reporting a bug or a work item with clearly defined and actionable tasks and outcomes.
- Discussions are the right place if the issue needs a discussion to agree upon a course of action or define an actionable piece of work.
Check out the definition of each discussion category below so that you can start your discussion in the proper place.
| Discussion Category | Discussion Subject |
|---|---|
| 📣 Announcements | This category is reserved for MDN Web Docs staff. While there is nothing in place to prevent others from posting here, we ask that you choose one of the other available categories. |
| 🔮 Browser compatibility data | Discussions related to the browser-compat-data project. |
| ✏️ Content | Discussions related to the content on MDN Web Docs. Note: This is not the place to ask for help with code examples. For code-related help, please join our community on Discourse. |
| 🙋 Content suggestions | Discussions related to ideas for new content or improvements to existing content on MDN Web Docs. You can propose your ideas here along with a description of how the change will be useful to our readers and/or links to relevant resources. We commonly label these as opportunity assessments. |
| 🎨 Design system | Discussions related to design improvements. Design is subjective, but we are always open to suggestions from the community. Any improvement that can help the MDN Web Docs experience even better for a wider audience is welcome. If you have constructive feedback around the design, user experience, and accessibility of MDN Web Docs, we'd love to hear from you. |
| 👩💻 Code examples | Discussions related to all code examples on MDN Web Docs. This includes interactive examples, live samples and static code examples. For help with general coding challenges on MDN Web Docs, please join our community on Discourse. |
| 🌐 Translated content | Discussions related to the translated-content repository covering our supported locales. This is also typically where announcements of macro deprecation will happen. |
| 👾 MDN Plus | Discussions related to the existing MDN Plus feature set as well as feature ideas. For MDN Plus support such as subscriptions, please refer to our official support channel. |
| 🛠️ Platform | Discussions related to the core MDN Web Docs platform. Your suggestions to improve the architecture and existing features, such as navigation and search, are welcome. However, if you believe you found a bug related to the platform, please report it on the Yari repository. This is also the place for discussions related to existing tooling, such as BoB, markdown, reusable workflows, etc. NOTE: This category is not for MDN Plus-related feature discussions. There is a separate discussion category for MDN Plus. |
| 🤖 Polls | This category is meant for use by the MDN Web Docs staff. We will use this category to run polls around topics where we need your input. So, keep your eyes peeled. 👀 |