I create documentation that solves real problems.

Technical writer focused on developer experience, documentation systems, and API guides.

This site showcases selected documentation projects that demonstrate my approach to technical content. Each case study represents a challenge solved through clear, structured documentation.

Documentation Portals

Backstage Implementation Guide

Documentation Engineer

Context: Backstage is an open-source developer portal used by platform engineering teams. Despite good official documentation, teams were struggling with understanding core concepts and implementation.

My contribution:

  • Created a comprehensive guide grounded in a real-world scenario using a fictional company (Koslog)
  • Authored step-by-step tutorials covering core features from initial setup through TechDocs integration
  • Built and published a working demo repository that teams could use as a reference
  • Identified and fixed an undocumented authentication error by contributing directly to the official Backstage documentation via PR
  • Proposed and implemented clearer language in the official docs to help new users understand GitHub authentication flows

Impact: The guide and demo project now serve as a reference for platform engineering teams implementing Backstage. Several teams have used my template as a starting point for their own deployments, and my contributions to the official docs have helped prevent common setup errors.

Ory Documentation Redesign

Documentation Engineer Contract

Context: Ory is an open-source identity management product trusted by companies like OpenAI. The documentation was comprehensive but needed reorganization to better support new adopters dealing with complex systems like OAuth2, Identities, and Permissions.

My contribution:

  • Completely redesigned the welcome page to provide a clearer entry point for new users
  • Restructured getting-started guides to follow a logical progression
  • Added detailed installation steps that were previously missing or assumed
  • Implemented a "Learning from Scratch" section for users new to identity management
  • Created framework-specific integration guides for React and Next.js

Impact: Improved discoverability of key documentation sections, leading to a better onboarding experience. Users could more easily understand how Ory's components fit together and find the specific implementation guidance they needed.

MonoConnect SDK Documentation

Technical Writer Side Project

Context: MonoConnect.js is a JavaScript SDK for integrating secure bank account linking. When I started, documentation was limited to an unstructured GitHub README, leading to numerous developer issues.

My contribution:

  • Conducted a full documentation audit based on source code, README, and GitHub issues
  • Migrated content from GitHub to a structured Mintlify documentation site
  • Created framework-specific integration guides for React, Angular, and Next.js
  • Implemented a CI pipeline to test all code examples, preventing documentation rot
  • Built a comprehensive API reference with method signatures and examples

Impact: The new documentation portal provided clear navigation, working code examples, and framework-specific guidance, reducing integration time for developers and decreasing support requests.

Technical Articles & Guides

Docker Init for Node.js

Technical Writer Contract

Context: When Docker released its Docker Init feature, Node.js developers struggled with implementation. The existing documentation didn't provide clear guidance for real-world applications.

My contribution:

  • Built a working example project demonstrating Docker Init with Node.js in a real application context
  • Created step-by-step instructions explaining the process and decisions
  • Published a GitHub repository with starter code for hands-on learning
  • Added visual aids showing terminal output and configuration details
  • Included best practices for container optimization specific to Node.js applications

Impact: The article now ranks #1 on Google for "docker init nodejs," positioned above the official documentation, and serves as the primary reference for Node.js developers implementing Docker Init.

Linux Command Guide for DevOps

Technical Writer 2023

Context: Many DevOps beginners struggle with the fundamentals of Linux commands when they first start working in terminal environments.

My contribution:

  • Created a beginner-friendly guide to essential Linux commands for DevOps engineers
  • Covered key concepts like file manipulation, process management, networking and SSH basics
  • Included practical examples showing real-world usage of each command
  • Provided clear explanations focusing on specifically DevOps-relevant use cases

Impact: The article has helped engineers transitioning to DevOps roles understand Linux fundamentals in a practical, hands-on context.

Documentation Systems & Tools

AI Documentation Assistant

Developer & Documentation Engineer 2024-Present

Current project: I'm developing an AI writing assistant for technical documentation, using embeddings and vector search to generate content that follows documentation best practices.

Key features:

  • Training on my documentation corpus to capture writing patterns and style
  • Integration with documentation systems via API
  • Consistency checking against style guides and terminology
  • Code example verification against API specifications

Goal: Create a tool that helps technical writers maintain consistency across large documentation projects while adhering to quality standards and technical accuracy.

Documentation Testing Framework

Technical Lead 2023

Context: Code examples in documentation often become outdated as APIs evolve, leading to frustrating developer experiences.

My contribution:

  • Developed a testing framework for automatically extracting and validating code examples from documentation
  • Created a CI pipeline that flags broken examples when APIs change
  • Implemented a reporting system that helps documentation teams prioritize fixes

Impact: Reduced documentation errors by catching issues before they reached production, improving developer trust in the documentation.

Technical Skills

Documentation Tools

  • Docs-as-code workflows
  • Mintlify, Docusaurus, GitBook
  • Markdown and MDX
  • OpenAPI specification
  • CI/CD for documentation testing

Development

  • JavaScript/TypeScript
  • React and Next.js
  • Node.js
  • GraphQL
  • Docker and containerization

Industry Knowledge

  • Information architecture
  • Technical SEO
  • User experience design
  • Accessibility standards
  • Content strategy

Collaboration

  • Cross-functional teamwork
  • Developer relations
  • Technical presentations
  • API documentation reviews
  • Documentation systems training

Documentation Philosophy

Documentation is a product, not an afterthought

Good documentation needs design, planning, and maintenance just like software. I approach documentation as a product with its own lifecycle, user needs, and success metrics.

Test everything, assume nothing

When I document a system, I build from scratch, test every step, and validate all code examples. This catches the "obvious" steps that are clear to experts but critical for new users.

Structure trumps prose

The organization of documentation is as important as the content itself. I focus on information architecture that guides users to the right information at the right time in their journey.

Documentation should anticipate failure

Great docs don't just show the happy path - they help users understand what went wrong and how to fix it. I create content that addresses common errors and troubleshooting scenarios.

Contact

I'm available for documentation projects, technical writing, and consulting on documentation systems and developer experience. If your docs are creating more questions than answers, let's talk.