Skip to main content

Introduction

Welcome to my technical writing portfolio​

This site collects the software documentation samples from my Technical writing portfolio. Docusaurus builds every page from Markdown and MDX source. The set covers developer guides, API references, product documentation, and the workflow behind each sample.

Portfolio navigation​

Browse the samples by deliverable type and domain:

Developer and system guides​

Sweepy job search documentation​

Sweepy queries applicant tracking systems and job boards, then ranks each posting against a resume. This Python tool is open source and includes a 13-page documentation set. It covers installation, profile setup, and PDF or CSV exports. It also documents a Model Context Protocol (MCP) server that runs sweeps from an AI assistant.

Get started​

  • Meet Sweepy. Explains what a sweep does, the five pipeline stages, and how Sweepy scores a resume.
  • Installing Sweepy. Walks through Python, Git, and repository setup on Windows, macOS, and Linux.
  • Running your first sweep. Follows a first sweep from profile creation to the progress readout.

Read the results​

The Sweepy documentation index collects the reference pages. It covers commands, configuration keys, developer notes, and the tool reference. It also lists the supported job sources and platforms.

API references​

Architecture and conceptual documentation​

Commit messages and pull requests​

Case studies​

To inspect the raw Markdown sources for these documents, browse the GitHub repository.

Docs-as-code workflow​

  • Authoring in Markdown and MDX using VS Code and Antigravity
  • Prose and style guide linting with Vale
  • Internationalization and translation with DeepL and Lara
  • System architecture diagramming with Mermaid
  • Writing product documentation for a command-line tool and its MCP server as part of each release
  • Version control and collaborative code review with Git and GitHub
  • API exploration and validation with Postman and Swagger/OpenAPI
  • Continuous deployment with Docusaurus

Technical stack​

  • Docusaurus. Generates static sites, navigation sidebars, and localized versions.
  • VS Code. Provides the primary editing surface for Markdown and MDX authoring.
  • Postman. Validates API endpoints and generates request/response examples.
  • Vale. Lints technical prose to enforce Google Developer Documentation guidelines.
  • Git and GitHub. Manages branch version control and site deployment.
  • Mermaid. Renders flowcharts and data pipeline diagrams.
  • Python and MCP. Run the Sweepy sweep engine and the tool server that connects it to AI assistants.
  • DeepL and Lara. Automate documentation translation into other languages.

Each page has a Markdown or MDX file in the same repository. Compare the rendered output with the text that produced it.

Every sample follows the same path from research and drafting to testing against real output, review, and publishing.