All Guides

Building a High-Signal DevRel Portfolio (Without Prior DevRel Experience)

How to craft proof-of-work assets—open source repos, deep-dive tutorials, recorded conference talks, and docs PRs—that grab hiring managers’ attention.

Key Chapter Takeaways
  • •Proof-of-work matters far more than past job titles in Developer Relations.
  • •Build an opinionated starter repo with outstanding README documentation.
  • •Record at least one clean 10-minute video walk-through to demonstrate speaking clarity.
  • •Contribute documentation improvements to open-source repositories to show initiative.
DR
DevRelJobs Editorial
Developer Relations Insights & Careers
10 min read

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.