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.
If you see something wrong on MDN Web Docs, it's best to open a GitHub issue in the relevant MDN GitHub repository.
If you're not sure whether to open an issue or start discussion, consider the following guidelines:
- Issues should be used for reporting a bug or a work item with clearly defined and actionable tasks and outcomes.
- Use Discussions when an issue requires a dialogue to agree upon a course of action or define an actionable piece of work.
- If your discussion doesn't progress or you're unsure of the next steps, refer to the Guidelines for managing and resolving discussions for advice on moving forward, including expectations on timelines.
Check out the subject 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 which documents web platform compatibility data for browsers. |
| ✏️ Content | Discussions related to the content on MDN Web Docs. Note: This is not the place to ask for coding assistance. If you're stuck, a good place to start is our Learn Web Development area. |
| 🎨 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, see our Communication channels. |
| 🌐 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 Mozilla's 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. 👀 |