Skill examples

My writing ability is a subset of what I do as a technical writer/documentation engineer. Here are some example projects that show some of my technical skills and knowledge.

CI code sample validator

I created a GitHub Action that validates code samples in committed Markdown files to reduce documentation rot. On every commit, the Action extracts any inline JavaScript code samples from the committed Markdown files and tests the code samples against a live background instance of the API. The GitHub build/deployment fails on any exit code other than 0.

MCP Markdown server

In this example project I created an MCP server that enables Claude Desktop to parse and query Markdown files in a local directory. It demonstrates my understanding of MCP servers and how MCP provides an interface for LLM applications to parse, query, and audit Markdown documents. Hypothetically, this could be extended to audit Markdown files for SEO keywords, style guide violations, and sensitive data like API keys. I worked with Claude Code and Claude Desktop to create this.

API documentation

I built and documented a functional Python/Flask REST API backed by a local SQLite database to manage and filter a song repertoire. I verified the endpoints locally using Postman, deployed the backend to Heroku, and integrated the collection with Fern to automatically compile and publish the live documentation every time the schema is updated.

This website

I built www.petewitcher-techwriter.com using the Astro web framework and the Starlight documentation framework, writing Markdown and MDX in VSC. I host the site with GitHub Pages and deploy it with GitHub Actions. The CI/CD pipeline automatically publishes the latest version of the site on every successful commit. I worked with Claude Code to configure the Astro site and the GitHub Action.