🎉 DevOps Interview Prep Bundle is live — 1000+ Q&A across 20 topicsGet it →
All Articles

How to Build an Open Source Portfolio as a DevOps Engineer (That Gets You Hired)

Open source contributions are the best DevOps portfolio signal. Here's exactly what to contribute, how to find issues, and how to present it to recruiters.

DevOpsBoysMay 27, 20265 min read
Share:Tweet

Most DevOps portfolios are just a GitHub with a few personal projects. That's fine. But engineers who contribute to real open source projects stand out immediately — because it proves you can work on production-grade codebases with real users.

Here's how to do it strategically.


Why Open Source Matters for DevOps Careers

When a recruiter sees you've contributed to ArgoCD, Prometheus, or Helm:

  • It proves you read and understand complex codebases
  • It shows you can work asynchronously with remote teams
  • It means real users depend on code you wrote
  • It's verifiable — they can see the PR, the review, the merge

A side project only you use can be faked. A merged PR in a 10k-star repo can't.


Where to Start: Pick the Right Project

Don't start with the biggest projects (Kubernetes, Terraform core). The bar is high, reviews take weeks, and it's demotivating for beginners.

Start with mid-size projects:

ProjectWhy it's good to start
Helm charts (bitnami, community)High activity, diverse issues
ArgoCDActive community, good first issues
KedaSmaller codebase, welcoming maintainers
OpenTelemetryDocs + code issues, very active
Grafana dashboardsLower technical barrier, high value
KarpenterGrowing fast, AWS engineers respond quick
Crossplane providersSpecific and small enough to understand

How to find them:

bash
# GitHub search — good first issues in DevOps tools
# https://github.com/search?q=label%3A%22good+first+issue%22+topic%3Adevops&type=issues
 
# Or by tool
# https://github.com/argoproj/argo-cd/issues?q=label%3A%22good+first+issue%22

Types of Contributions (Easiest to Hardest)

1. Documentation fixes (Start here)

Every project has outdated docs. Find a command that doesn't work, a missing step, or a typo.

bash
# Clone the repo
git clone https://github.com/argoproj/argo-cd
cd argo-cd
 
# Find what you want to fix
grep -r "deprecated" docs/
# Or just use the tool and notice what's missing/wrong

Documentation PRs get merged quickly, you learn the contribution workflow, and maintainers remember contributors who help with docs.

2. Add examples / improve README

If you figured out how to do something that wasn't documented — add it.

"I just spent 3 hours figuring out how to configure X. I added an example to the docs so nobody else has to."

This is genuinely valuable and always appreciated.

3. Fix a "good first issue"

Filter GitHub issues by good first issue label. These are intentionally scoped for new contributors.

Read the issue. Read the related code. If you can understand what's needed, try it.

bash
# Fork the repo, create a branch
git checkout -b fix/issue-1234-description
 
# Make the change
# Run tests
make test
 
# Open a PR with a clear description

4. Write a test for uncovered code

Find a function with no test. Write one. Tests PRs are almost always welcome.

bash
# Find files with low coverage (if the project has coverage reports)
# Or just look for complex functions with no corresponding test file

5. Fix an actual bug

Once you're comfortable with the codebase, pick a real bug. Comment on the issue first: "I'm working on this, here's my approach." Maintainers will tell you if you're on the right track before you spend hours on it.


The Contribution Workflow

bash
# 1. Fork and clone
git clone https://github.com/YOUR-USERNAME/argo-cd
cd argo-cd
 
# 2. Add upstream remote
git remote add upstream https://github.com/argoproj/argo-cd
 
# 3. Create a branch
git checkout -b docs/fix-installation-step
 
# 4. Make your change
# Edit the file(s)
 
# 5. Check if there's a contribution guide
cat CONTRIBUTING.md
 
# 6. Run linting/tests if specified
make lint
make test
 
# 7. Commit with good message
git commit -m "docs: fix missing --insecure flag in getting started guide"
 
# 8. Push and open PR
git push origin docs/fix-installation-step
# GitHub will show a link to open a PR

PR description template:

markdown
## What does this PR do?
Fixes the installation docs — the `--insecure` flag was missing from 
the argocd login command example, causing connection refused errors 
for new users (referenced in #1234).
 
## How to test it
Follow the getting started guide in docs/ with this change applied.
 
## Related issues
Closes #1234

Building a Pattern: 1 Contribution/Month

You don't need to be a full-time maintainer. One meaningful contribution a month adds up:

  • Month 1: Fix a doc in ArgoCD
  • Month 2: Add a test to KEDA
  • Month 3: Fix a small bug in Helm
  • Month 6: Your GitHub has 6 merged PRs in real tools
  • Month 12: You've contributed to 4+ projects

That GitHub profile tells a story no personal project can.


How to Present It to Recruiters

On your resume:

Open Source Contributions
- ArgoCD (13k⭐): Fixed JWT refresh bug in API server [PR #8421, merged]
- KEDA (7k⭐): Added unit tests for Kafka scaler trigger [PR #4892, merged]
- Helm Docs: Updated values.yaml reference for v3.14 [PR #342, merged]

On LinkedIn: Post when you get a PR merged. Even a small one. "Excited to have my first PR merged in ArgoCD — fixed X" gets engagement from the DevOps community and signals to recruiters.


You Don't Need to Be a Go Expert

Most DevOps tools are in Go. But contributions don't require being a Go expert:

  • Docs are usually Markdown
  • Tests often follow existing patterns you can copy
  • Some projects have Python/Shell components
  • YAML/configuration changes are valid contributions too

You learn Go by reading and modifying the code. You don't need to know it perfectly before starting.


Projects Worth Targeting in 2026

Based on hiring demand and contribution-to-career ROI:

  1. ArgoCD — every K8s shop uses it
  2. OpenTelemetry — observability is everywhere
  3. Karpenter — hot in AWS/EKS world
  4. Cilium — CNI/networking contributions visible at CNCF
  5. Crossplane — growing fast, smaller community

KodeKloud — before contributing to a project, make sure you understand the tool deeply. KodeKloud courses give you the hands-on foundation.

One merged PR in a real open source project is worth 10 personal tutorial projects. Start small, stay consistent, and your GitHub profile becomes the best job application you have.

🔧

Today I Fixed

Short real fixes from production — posted daily

Browse fixes
Newsletter

Stay ahead of the curve

Get the latest DevOps, Kubernetes, AWS, and AI/ML guides delivered straight to your inbox. No spam — just practical engineering content.

Related Articles

Comments