-
Notifications
You must be signed in to change notification settings - Fork 16
Description
Page or section
https://devex.intersectmbo.org/docs
Issue description
Several questions and misunderstandings recur across GitHub issues, Discord discussions, and community calls. These are not edge cases, but predictable points of confusion for new and returning contributors.
Currently, this information is either scattered across different pages or exists only as implicit knowledge held by the dev advocates. As a result, contributors spend unnecessary time searching for answers or make incorrect assumptions, and instructors/advocates repeatedly answer the same questions. There is no single, clear place where common questions are addressed directly in a concise and accessible way.
Proposed change
Add a dedicated FAQs (Frequently Asked Questions) section to the DevEx documentation to address the most common contributor and developer questions.
The FAQs should:
- Be written in clear, professional, and approachable language
- Focus on clarifying common misunderstandings rather than restating full documentation
- Include short, direct answers with links to relevant detailed docs where appropriate
- Cover high-confusion areas such as but not limited to:
- Contributor vs maintainer roles and expectations
- How decisions are made and where governance applies
- How funding, proposals, and repositories relate
- Where to ask questions and how to get help
- How to join intersect
- When are meetings
- Setting up a dev environment
The FAQs should be linked from relevant documentation pages so they are easy to discover.
Checks
- I searched existing issues and discussions
- This is about documentation (not a feature request or bug)