Technical Writer · Prague

I turn complex systems into documentation. |

Documentation Systems · Docs-as-Code · Developer Content

Douglas Ebhoman — Technical Writer
Scroll
7 portfolio projects 5 posts published 10-part blog series in progress 3 documentation sites live Available for hire

Selected Work

Documentation built with the same discipline it teaches.

Git and GitHub for Technical Writers — Six Part Series
01

Git & GitHub for Technical Writers

A six-part documentation series built and deployed as a live static site. Written in Markdown, version-controlled in Git, and deployed automatically via GitHub Actions — the same workflow the series teaches.

  • Docs-as-Code
  • MkDocs
  • GitHub Actions
  • Markdown
Read the Series
OpenWeather API Getting Started Guide
02

OpenWeather API — Getting Started Guide

Hands-on API documentation built using the OpenWeather REST API and Postman — covering authentication, endpoint structure, request parameters, and response interpretation. Structured in Markdown following Docs-as-Code standards.

  • REST API
  • Postman
  • API Documentation
  • Markdown
Read the Docs
Systems Over Sentences — A Technical Writer's Blog
03

Systems Over Sentences

A technical writer's evolution — from producing content to designing documentation systems. Long-form series on Docs-as-Code, information architecture, and the thinking behind great developer documentation.

  • Documentation
  • Systems Thinking
  • Technical Writing
  • Series
Visit the Blog
Personal Website Setup Guide — GitHub Pages, Cloudflare, Custom Domain
04

Personal Website Setup Guide

A practical guide to building a personal website with a custom domain and professional email — covering GitHub Pages, Cloudflare DNS, HTTPS configuration, and Gmail SMTP. Includes troubleshooting for every common failure point.

  • GitHub Pages
  • Cloudflare
  • DNS
  • Technical Writing
Read the Guide
Static Portfolio Architecture Review — Frontend Security and Documentation
05

Static Portfolio Architecture Review

A documentation-led review of a static frontend website — covering architecture decisions, security considerations, known limitations, and deployment strategy. The documentation is the product.

  • Architecture
  • Security
  • Static Sites
  • Technical Writing
View the Repo
douglasebhoman.com — Site Documentation
06

douglasebhoman.com — Site Documentation

Technical documentation for this portfolio site — covering architecture decisions, local setup, deployment pipeline, content workflow, and contributing guidelines. The site documents itself.

  • MkDocs
  • GitHub Actions
  • Docs-as-Code
  • Architecture
Read the Docs
MkDocs for Technical Writers — A complete guide to building and deploying documentation sites
07

MkDocs for Technical Writers

A complete 11-page guide to building and deploying documentation sites with MkDocs — covering installation, configuration, content writing, GitHub Pages deployment, custom domains, and troubleshooting. Written for technical writers adopting Docs-as-Code workflows.

  • MkDocs
  • GitHub Pages
  • Docs-as-Code
  • Technical Writing
Read the Guide

Documentation is infrastructure.
I treat it that way.

Documentation fails in predictable ways. It drifts from the product. It loses its owner. It answers the question nobody asked while leaving the real question unaddressed. Most teams know this is happening. Almost none have a system to stop it.

That is what I build.

I am Douglas Ebhoman, a technical writer based in Prague who designs documentation systems for DevTools and SaaS companies. Not content strategies. Not style guides. Systems — the architecture that decides how documentation is structured, versioned, deployed, and maintained as products grow and change.

My background is unusual for this field. I started as a creative writer, which means I arrived at technical writing already knowing how to earn a reader's attention before asking for it. Most technical writers learn to write clearly. I learned to write in a way that makes people want to keep reading.

I do not just describe systems. I make them legible.

If you are building something engineers need to understand, that is the problem I solve.

Location Prague, Czechia
Availability Open to opportunities
Douglas Ebhoman

What People Say

"

Douglas has nailed it with his 'Git & GitHub for Technical Writers' series. It's a must-read if you want to adopt Git and GitHub for product documentation. He has a knack for writing in a simple, clear style — it's a pleasure to read. I'm looking forward to more great insights.

Tejas Dandekar Associate Director, DP&S

What I Bring to a Team

Not a list of tools. A demonstration of how I think and what I build.

I build infrastructure that keeps documentation accurate as products grow.

Most documentation systems are built once and left to drift. I design the architecture, workflows, and automation that make documentation maintainable as the product evolves — not just well-written at launch.

  • Git + GitHub
  • MkDocs + Material
  • GitHub Actions
  • Markdown
  • CI/CD pipelines
Local Write in Markdown
git push
GitHub Review + merge
gh-deploy
Live Site Always current

The same workflow this portfolio site uses.

I design structure that lets readers find what they need without asking a colleague.

The Diátaxis framework separates documentation into four distinct types. Most documentation fails because it mixes them — a tutorial that becomes a reference, a how-to that turns into an explanation. Click each quadrant to see what belongs there.

  • Diátaxis framework
  • Single Source of Truth
  • Information hierarchy
  • Internal linking
  • Content strategy
Tutorial Learning-oriented
Takes the reader by the hand through a learning experience. Success is the reader completing the task, not understanding it fully.
How-to Guide Task-oriented
Guides the reader through a specific real-world task. Assumes competence. Answers "how do I accomplish X?"
Reference Information-oriented
Dry, factual, complete. The reader consults it, not reads it. API documentation is the canonical example.
Explanation Understanding-oriented
Illuminates the topic from a higher perspective. Answers "why does this work this way?" Not action-focused.

Click any quadrant to see what belongs there.

I write documentation that engineers read voluntarily.

The difference between documentation engineers ignore and documentation they trust is not accuracy — it is precision. The same information, written for the right reader, in the right register, at the right level of detail. See the difference below.

  • API documentation
  • Technical blog writing
  • Pull request discipline
  • Developer experience
  • Code annotation
Raw API response — undocumented
{
  "status": 200,
  "data": {
    "token": "eyJhbGc...",
    "expires": 3600,
    "scope": "read:docs write:docs"
  }
}
Documented — written for the engineer
// token: Use this in the Authorization header
// for all subsequent API requests.
// expires: Seconds until the token expires (1 hour).
// Refresh before expiry to avoid 401 errors.
// scope: Permissions granted. write:docs required
// for POST and PATCH endpoints.
{
  "status": 200,
  "data": {
    "token": "eyJhbGc...",
    "expires": 3600,
    "scope": "read:docs write:docs"
  }
}

The code is identical. The documentation makes it usable.

Documentation Health Check

Six questions. Sixty seconds. A precise diagnosis of where your documentation system stands.

1
2
3
4
5
6

Question 1 of 6

What is the biggest documentation problem your team faces right now?

Question 2 of 6

When did your documentation last cause a support ticket or user confusion?

Question 3 of 6

Does your documentation assume knowledge your reader does not have?

Question 4 of 6

Does every page in your documentation link to the next logical step for the reader?

Question 5 of 6

Do you have a named owner for each section of your documentation?

Question 6 of 6

How is your documentation currently managed?

Is your product growing faster than your documentation can keep up with?

Most teams reach that point and do not know it until something breaks. That is the problem I solve — documentation that works as a system, maintained deliberately as the product evolves.

Available for new engagements from June 2026 · Full-time and freelance

Not sure where to start?

Run the free Documentation Health Check above. Six questions, sixty seconds. Once you have your score, send it to me and I will respond with a specific assessment of your next best step.

Run the Health Check