Skip to content

Commit 11a57bb

Browse files
committed
publish new post 'Using open source work to offset the bias publish new post 'Using open source work to offset the bias against short-term contracts'; update About me; update pdf copy or resume; update link in portfolio
1 parent 4132996 commit 11a57bb

6 files changed

+79
-7
lines changed

_layouts/home.html

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -8,7 +8,7 @@
88
<!-- About Me Section -->
99
<div class="about-me">
1010
<h2>About me</h2>
11-
<p>I'm a software developer, technical writer, and active open-source contributor. I’ve worked on major projects such as Wagtail CMS and Ubuntu. My experience spans documentation, programming, mentorship, community building, and content creation.</p></div>
11+
<p>I'm a software developer, technical writer, and active open-source contributor. I’ve worked on major projects such as Wagtail CMS and Ubuntu. My experience spans documentation, programming, mentorship, community building, content strategy, and content creation.</p></div>
1212

1313
{% assign all_pinned = site.posts | where: 'pin', 'true' %}
1414
{% assign all_normal = site.posts | where_exp: 'item', 'item.pin != true and item.hidden != true' %}

_posts/2025-11-01-how to-conduct-user-research-for-documentation.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -12,7 +12,7 @@ image:
1212
published: true
1313
---
1414

15-
Most technical writers build documentation around assumptions. They assume users need detailed API references, want exhaustive tutorials, or will read every section in order. But assumptions often fail, and user behavior tells a different story.
15+
Many technical writers build documentation around assumptions. They assume users need detailed API references, want exhaustive tutorials, or will read every section in order. But assumptions often fail, and user behavior tells a different story.
1616

1717
User research is the clearest way to uncover that behavior. So _what is user research?_ User research is the process of investigating user behaviors, needs, and motivations through observation and feedback. In documentation, this means studying how users navigate your content, what information they seek, and what barriers prevent them from finding answers.
1818

Lines changed: 72 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,72 @@
1+
---
2+
title: "Using open source work to offset the bias against short-term contracts"
3+
description: Using open-source work to offset bias against short-term contracts.
4+
date: 2025-11-17 00:00:00 +0100
5+
categories: [Documentation]
6+
tags: [documentation, career, open-source]
7+
pin: false
8+
image:
9+
path: /assets/img/cover-images/using-open-source-work-to-offset-the-bias-against-short-term-contracts.png
10+
alt: Cover image showing the words “Open-Source Contributions & Short-Term Contracts” in bold text.
11+
published: true
12+
---
13+
14+
Short-term contracts are common in technical writing, but they come with a reputation problem. Even when you do excellent work, a series of brief engagements can raise questions during hiring. Open-source work offers a practical way to offset that bias and build a stronger professional profile.
15+
16+
Technical writing roles are sometimes short-term because businesses seek specialized, time-bound expertise. These contracts typically last less than twelve months and focus on specific documentation needs, while long-term contracts involve deeper engagement with product teams and release cycles.
17+
18+
Some technical writers rely on short-term contracts because they are the most accessible opportunities available to them. Factors such as location, market saturation, and personal circumstances also influence the types of roles they receive.
19+
20+
## The advantage of short-term contracts
21+
22+
Short-term contracts offer clear advantages. One important advantage is that short-term contracts expose you to diverse industry experience faster than long-term contracts. You can work in healthcare, fintech, and e-commerce within a few years. Each contract exposes you to different documentation systems, style guides, and user bases.
23+
24+
For instance, you can spend eight months documenting API endpoints for a payment processing company. Then your next contract puts you in a medical device startup, writing regulatory compliance documentation. Six months later, you're creating user guides for enterprise project management software. In less than two years, you've gained expertise that would take many years to accumulate in a single company.
25+
26+
## The downside of short-term contracts
27+
28+
Despite the clear advantages, short-term contracts have their downsides. In my experience, the major downside is the bias many potential employers and recruiters hold against them. They view a resume full of brief engagements with suspicion and may question your loyalty. They wonder if you lack the persistence to work through difficult problems or challenging team dynamics.
29+
30+
Some assume you were let go from each position. Others think you’re a job hopper who will leave as soon as a better offer appears. These assumptions are mostly wrong, but this is the reality you face when your resume shows a pattern of short-term engagements.
31+
32+
## Open source to the rescue
33+
34+
The right balance of short-term and long-term engagements is best. This mix lets you gain diverse industry experience while avoiding the red flags that come with a resume full of short-term contracts.
35+
36+
The question now is: how do you get long-term engagements when long-term contracts are scarce?
37+
38+
Working on open source projects offers a solution. While <a href="https://damilola-oladele.dev/posts/documentation-experience-in-open-source/" target="_blank" rel="noopener noreferrer">getting started with open source isn't easy</a>, it's often easier than finding a long-term contract. This is because many open-source projects have documentation problems. So most maintainers are eager to find experienced technical writers who can commit to helping out over an extended period.
39+
40+
### Finding an open source project
41+
42+
Once you decide to pursue open-source work, the next step is finding the right project.
43+
44+
Start with projects you already use in your daily work. If you rely on a particular library, package, or framework, investigate whether they need documentation help. Since you already understand the tool, you have a head start on contributions.
45+
46+
You can also explore platforms like <a href="https://openhub.net/" target="_blank" rel="noopener noreferrer">Open Hub</a>, <a href="https://github.com/explore" target="_blank" rel="noopener noreferrer">GitHub Explore</a>, <a href="https://libraries.io/" target="_blank" rel="noopener noreferrer">Libraries.io</a>, and <a href="https://sourceforge.net/" target="_blank" rel="noopener noreferrer">SourceForge</a>. Then reach out to their maintainers through their communication channels. Many projects use Discord, Slack, or Discourse for community discussions. You can introduce yourself and express interest in contributing to documentation. In some cases, you might need to send an email directly to project maintainers.
47+
48+
Some projects host their source code on GitHub or GitLab. You can reach out by commenting on documentation-related issues or searching for maintainer contact information in repository files. Also, many maintainers include their public social handles in their profiles. Use the information to reach out to them.
49+
50+
Understand that this process takes time and effort. You'll need to reach out to multiple projects to increase your chances of finding the right fit. Not every project will respond, and not every response will lead to a commitment. So be ready for many disappointments.
51+
52+
### Selecting the right open source project
53+
54+
Any open-source project with documentation work is valuable, but some are easier to contribute to, and some are more valuable than others.
55+
56+
Start by prioritizing projects with active communities. This ensures you can get help when getting started, understand the project’s documentation standards, and receive faster feedback on your contributions. An active community also signals a healthy project that is likely to continue for years.
57+
58+
At the same time, consider the size and popularity of the project. Contributing to a well-known project carries more weight with potential employers than working on a small or obscure one. Larger projects also tend to have better-organized documentation processes and clearer contribution guidelines.
59+
60+
Finally, whenever possible, focus on open-source projects that are products themselves. These projects operate like commercial products, even though they are open source. They have dedicated user bases, regular release cycles, product roadmaps, and professional maintenance standards. Think of projects like <a href="https://www.djangoproject.com/" target="_blank" rel="noopener noreferrer">Django</a>, <a href="https://kubernetes.io/" target="_blank" rel="noopener noreferrer">Kubernetes</a>, <a href="https://wagtail.org/" target="_blank" rel="noopener noreferrer">Wagtail</a>, or <a href="https://www.postgresql.org/" target="_blank" rel="noopener noreferrer">PostgreSQL</a> that companies actually build their businesses on.
61+
62+
This distinction matters more than you might think. Working on open-source projects that are actual products demonstrates to potential employers that you have experience in a product environment. It shows that you understand end-users’ needs, feature documentation, release cycles, and cross-functional collaboration.
63+
64+
### Doing it right
65+
66+
Finding and selecting an open source project isn't enough. Since open-source work is easy to track, you can't make minor contributions just to add the experience to your resume.
67+
68+
Potential employers can visit the project repository and see exactly what you contributed. They can review your pull requests, read the documentation you wrote, and verify the scope of your involvement. Claiming significant contributions when you’ve only fixed typos or formatting issues will backfire.
69+
70+
Also, since the goal is to offset the disadvantage of short-term contracts, your open-source engagement needs to be long term. Commit to working on the project for more than 12 months. This duration demonstrates the same qualities that employers look for in long-term contract candidates: dedication, reliability, and the ability to see complex projects through to completion.<br><br>
71+
72+
This post isn’t meant to create bias against people who prefer short-term contracts or those who have no choice but to accept them. The goal is to share a strategy that helps technical writers build stronger professional profiles when opportunities are limited. A combination of short-term contracts and long-term commitments through substantial open-source work creates a balanced approach that supports your career growth and presents a compelling resume.

_tabs/portfolio.md

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -271,15 +271,15 @@ gap: 10px;
271271
<h2>Articles</h2>
272272
<input type="text" id="searchBoxArticles" placeholder="Search articles...">
273273
<div class="card-container" id="articles">
274-
<div class="card"><a href="https://damilola-oladele.github.io/posts/get_started_with_lxc/" target="_blank">Get started with LXC</a></div>
274+
<div class="card"><a href="https://damilola-oladele.dev/posts/get_started_with_lxc/" target="_blank">Get started with LXC</a></div>
275275
<div class="card"><a href="https://www.freecodecamp.org/news/unit-testing-in-python/" target="_blank">How to Write Unit Tests in Python – with Example Test Code</a></div>
276-
<div class="card"><a href="https://damilola-oladele.github.io/posts/the-blockchain-trilemma-challenge/" target="_blank">The blockchain trilemma challenge</a></div>
277-
<div class="card"><a href="https://damilola-oladele.github.io/posts/what-are-smart-contracts-on-blockchain/" target="_blank">What are smart contracts on blockchain?</a></div>
278-
<div class="card"><a href="https://damilola-oladele.github.io/posts/juno-bringing-decentralization-to-starknet/" target="_blank">Juno: Bringing decentralization to Starknet</a></div>
276+
<div class="card"><a href="https://damilola-oladele.dev/posts/the-blockchain-trilemma-challenge/" target="_blank">The blockchain trilemma challenge</a></div>
277+
<div class="card"><a href="https://damilola-oladele.dev/posts/what-are-smart-contracts-on-blockchain/" target="_blank">What are smart contracts on blockchain?</a></div>
278+
<div class="card"><a href="https://damilola-oladele.dev/posts/juno-bringing-decentralization-to-starknet/" target="_blank">Juno: Bringing decentralization to Starknet</a></div>
279279
<div class="card"><a href="https://www.freecodecamp.org/news/how-to-use-oop-in-python/" target="_blank">How to Use Object-Oriented Programming in Python – Explained With Examples</a></div>
280280
<div class="card"><a href="https://www.freecodecamp.org/news/django-model-relationships/" target="_blank">How to Define Relationships Between Django Models</a></div>
281281
<div class="card"><a href="https://www.freecodecamp.org/news/what-is-the-dom-explained-in-plain-english/" target="_blank">What is the DOM? The Document Object Model Explained in Plain English</a></div>
282-
<div class="card"><a href="https://damilola-oladele.github.io/posts/documentation-experience-in-open-source/" target="_blank">Why gaining documentation experience in open source is hard</a></div>
282+
<div class="card"><a href="https://damilola-oladele.dev/posts/documentation-experience-in-open-source/" target="_blank">Why gaining documentation experience in open source is hard</a></div>
283283
<div class="card"><a href="https://www.freecodecamp.org/news/how-to-stay-motivated-while-learning-to-code/" target="_blank">How to Stay Motivated While Learning to Code</a></div>
284284
</div>
285285
<!-- Modals -->
28.3 KB
Loading
6 Bytes
Binary file not shown.

0 commit comments

Comments
 (0)