Skip to content

Michael Scarborough

Technical Writer and Editor

Technical writer and editor with a background in macOS systems engineering and enterprise IT. I create user guides, administrator documentation, knowledge base articles, workflow documentation, and structured writing samples for technical teams and end users.

My experience includes documenting real-world technical workflows in support, administration, and enterprise environments, with a focus on clarity, structure, usability, and audience-appropriate communication. I also serve as a Technical Editor for Apache OpenOffice documentation, reviewing and improving published user guide content for consistency, readability, and technical accuracy.

This portfolio includes selected writing and editing samples in Markdown, XML, and GitHub-based formats, including onboarding guides, troubleshooting content, administrator documentation, technical editing work, and introductory DITA-based structured authoring samples. I have also completed Scriptorium’s Introduction to DITA course and have a strong interest in Markdown-based documentation, structured authoring, and modern documentation workflows.

Managed macOS Onboarding Guide

Task-based end-user documentation for setting up a company-managed macOS device in an enterprise environment. Demonstrates onboarding workflows, authentication and security integration, and user-focused troubleshooting.

KB Article: Troubleshooting Compliance Failures on Jamf-Managed Macs

Internal knowledge base documentation for diagnosing and remediating compliance failures on Jamf-managed Macs. Demonstrates structured troubleshooting, remediation guidance, and support-focused writing for technical teams.

KB Article: Troubleshooting VPN Certificate Issues on Managed macOS Devices

Internal knowledge base documentation for diagnosing and resolving certificate-related VPN connection failures on managed macOS devices. Demonstrates structured troubleshooting, endpoint management awareness, escalation guidance, and support-focused writing for enterprise IT teams.

Migrate User Administrative Tool Documentation

Administrator documentation for an AppleScript-based tool used to restore ownership and group permissions after macOS reimaging. Demonstrates tool documentation, warning, and prompt revision, maintainable commenting, and admin-focused messaging.

DITA Sample: Managed macOS Onboarding Guide

A structured authoring sample that adapts a managed macOS onboarding guide into DITA using concept, task, reference, troubleshooting, and map-based organization. Demonstrates foundational DITA skills, structured XML authoring, and topic-based documentation design.

Additional Samples

Apache OpenOffice Technical Editing

Technical editing sample based on published Apache OpenOffice documentation. Demonstrates structural editing, clarity improvements, consistency editing, and before-and-after editorial examples.

Atari Computer User Guide

A Markdown-based user guide created to apply technical writing principles to legacy computer documentation. Demonstrates procedural writing, setup guidance, and troubleshooting for users new to older systems.

Documentation Strengths

  • Technical writing
  • Technical editing
  • Administrator documentation
  • User guides
  • Knowledge base and troubleshooting content
  • Process and workflow documentation
  • Procedural and task-based writing
  • Markdown, XML, GitHub, and version-controlled documentation workflows
  • Structured authoring and DITA fundamentals
  • Topic-based writing
  • macOS and enterprise IT documentation