A community-maintained hub of DevRel best practices, guides, and resources in the field of Developer Relations.
The goal is to co-create a living, evolving resource that documents Developer Relations concepts, strategies, and experiences—built by the DXMentorship community, for the global tech ecosystem. It will showcase the collective knowledge and serve as a high-value project members can add to their portfolios.
Thanks for your interest in contributing! Here's how to get started:
- Fork the repository
- Clone your fork:
git clone https://github.com/yourusername/dx-devrel-guide.git - Install the Mintlify CLI to preview the documentation changes locally:
npm i -g mintlify - Start the dev server:
mintlify dev
- All docs are in the
docs/folder. - Follow the file naming conventions:
lowercase-with-dashes.mdx - Use
---frontmatter for the title, e.g.:
---
title: Developer Advocacy
---
## Public Speaking
...Choose a topic to contribute to with the topic name and assign yourself. Add your name when you start working on them.
- What is DXMentorship?
- Purpose of this guide
- How to contribute
- Definitions & origins - assigned to Faith
- Core pillars: Advocacy, Enablement, Community, Feedback Loops
- Why DevRel matters
- Public speaking
- Content creation (blogs, videos, docs)
- Developer champions
- Tooling & DX audits
- Documentation best practices
- Feedback collection
- Events & meetups
- Online community management
- Onboarding and retention strategies
- KPIs & OKRs
- Qualitative vs. Quantitative metrics
- Reporting to leadership
- Roles in DevRel (Advocate, Educator, Manager, etc.)
- Skills & tools
- Breaking into DevRel
- Real-life examples from the community
- Lessons learned
- Tools we love
- Books
- Podcasts
- Communities to join
- Courses
- List of contributors
- GitHub profiles
- LinkedIn/portfolio links
- Jobs in DevRel
We appreciate all contributors! To add yourself:
- Add your profile photo (square format recommended) to
public/images/contributors/with filename formatfirstname-lastname.jpg - Edit
community-authors.mdxand add your card to the CardGroup following the template in the file.
Here's a starter for developer-advocacy.mdx:
---
title: Developer Advocacy
---
## Public Speaking
How DevRel professionals speak at conferences to build awareness and trust.
## Content Creation
Creating blog posts, videos, and tutorials.
## Developer Champions
Empowering community members to represent the product.We'll run the documentation effort like a mini open-source project:
- Each contributor selects a section to work on (from the checklist above).
- Contributors submit pull requests via GitHub.
- Clan leads and reviewers provide feedback and merge updates.
- Contributors are listed in the "Community Authors" section with links to their profiles.
- Daily check-ins will help us track progress, support contributors, and celebrate wins.
DxDevRel Guides wouldn't be DxDevRel Guides without you. Every contribution counts. Thank you for being part of this journey.