Skip to content

Michael Scarborough

Technical Writer and Editor

Technical writer and editor with a background in macOS systems engineering, endpoint management, and enterprise IT. I create user guides, administrator documentation, knowledge base articles, workflow documentation, and structured writing samples that help technical teams and end users complete tasks, troubleshoot issues, and follow processes more consistently.

My experience includes documenting real-world workflows in support, administration, and managed-device 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 structured authoring, Markdown-based documentation, 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 clear onboarding guidance, authentication and security-related setup, and user-focused troubleshooting designed to support a more consistent setup experience.

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 intended to help technical teams investigate issues more consistently and determine next steps.

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 environments.

Migrate User Administrative Tool Documentation

Administrator documentation for an AppleScript-based tool used to restore ownership and group permissions after macOS reimaging. Demonstrates administrator-focused documentation, revised prompts and warnings, maintainable commenting, and clearer messaging to support more reliable tool usage.

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 and consistency improvements, and before-and-after editorial examples focused on improving readability and usability.

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 unfamiliar with older systems.

Skills

  • Technical writing and editing
  • User and administrator documentation
  • Knowledge base and troubleshooting content
  • Process and workflow documentation
  • Procedural and task-based writing
  • Structured authoring and topic-based writing

Tools

  • Markdown
  • GitHub and version-controlled documentation workflows
  • DITA / XML (foundational)
  • macOS and Jamf Pro (subject-matter platforms)