When applying for a software engineering job, your GitHub commit history and code tests carry the weight. But when applying for a DevRel job, a hiring manager wants to see proof of your ability to teach, inspire, and engage developers.
If you don’t have a prior "Developer Advocate" title on your resume, a well-structured portfolio is your ticket to the interview stage. Here are the 4 high-signal artifacts you should include.
Artifact 1: The "Show-Don't-Tell" Sample Repository
Don't just build another generic to-do app. Build an opinionated starter repo integrating modern developer tools (e.g. Next.js + Supabase + Stripe + Tailwind).
- Include a comprehensive, beautifully formatted
README.md. - Add a 1-click deploy button (Vercel, Railway, etc.).
- Include architecture diagrams and troubleshooting FAQs.
Artifact 2: Two Deep-Dive Technical Tutorials
Write two technical articles on your personal blog, Dev.to, or Hashnode. Ensure they follow best practices:
- Solve a non-trivial problem that isn't already covered in the official docs.
- Include syntax-highlighted code snippets and copyable terminal commands.
- Add diagrams or animated GIFs showing the final result.
Artifact 3: A 10-Minute Recorded Video / Lightning Talk
Video is a primary medium for developer advocacy. Record a clean, high-audio-quality 10-minute video explaining a technical concept or walking through your sample repo.
- Demonstrates your vocal clarity, presentation pacing, and screen-sharing setup.
- Proves you are comfortable speaking in public without stage fright.
Artifact 4: Merged Documentation PRs in Public Repos
Find an open-source tool you use and submit pull requests improving their quickstart guide, fixing broken code samples, or adding missing error explanations.
Hiring managers love seeing that you proactively improve the developer ecosystem without being paid for it.
How to Package Your Portfolio
Create a clean, minimalist personal website or GitHub profile README containing links to these 4 artifacts. When you apply for DevRel jobs, link directly to this portfolio in your application notes.