Documentation Systems & Strategy

Beyond individual deliverables, I’ve led documentation infrastructure initiatives that enable self-service authoring, improve content quality at scale, and prepare documentation systems for emerging AI workflows.

AsciiDoc Modernization Program

In 2022, I began pioneering documentation format modernization to lower contribution barriers and position documentation infrastructure for emerging AI workflows. Starting with ROSA, I established an early continuously maintained AsciiDoc implementation that served as a foundation for broader organizational adoption, including EKS and additional service teams.

ROSA Foundation

ROSA required close collaboration with external Red Hat technical writers. I researched and proposed AsciiDoc adoption over the standard format, recognizing that a markdown-like source format would lower barriers for contributions from a wider variety of contributors, both human and AI.

I established ROSA’s AsciiDoc implementation and created a framework enabling safe contribution from product managers and engineers. This foundation work proved sustainable—ROSA has remained continuously maintained in AsciiDoc format since adoption. The lessons learned from ROSA informed conversion standards that were later adopted by other teams.

Cross-Service Expansion

The ROSA framework demonstrated scalability potential. I influenced EKS adoption of AsciiDoc and provided strategic and implementation support for their transition. Following EKS’s adoption, the team reported contributor participation increased to 25%, demonstrating the format’s effectiveness in lowering contribution barriers.

I led conversion of six SAP on AWS guides to AsciiDoc, establishing a self-service documentation model enabling SAP service team to maintain content independently, reducing documentation team dependencies while preserving quality through review gates.

Regulated Regions Modernization

I converted AWS Secret Region User Guide and AWS GovCloud User Guide to AsciiDoc, and served as primary contributor to AWS Top Secret Region User Guide conversion. These projects required special handling due to compliance-sensitive content and export control considerations.

To accelerate these conversions while maintaining quality, I developed AI-assisted Python transformation scripts using Claude coding assistant. This automation reduced conversion cycles from days to hours while preserving human-in-the-loop validation for compliance requirements and technical accuracy.

The tooling and processes I developed from this work have been adopted by platform engineering teams and other writers, who continue building on this foundation to improve conversion processes across the organization.

Impact

Measurable outcomes:

EKS contributor participation increased to 25% post-AsciiDoc adoption
Automation tooling reduces conversion time from days to hours
Framework voluntarily adopted across multiple service teams
Self-service models established reducing documentation team dependencies
Successfully converted: ROSA guide, 6 SAP guides, 2 regulated region guides, contributed to 3rd regulated guide

Strategic positioning:

Documentation infrastructure prepared for AI-assisted workflows
Lightweight format more accessible to LLM processing
Faster iteration cycles through simplified markup
Quality maintained through automated validation and review gates
Foundation enabling continued organizational adoption

Tools & technologies:

AsciiDoc lightweight markup format
Python transformation scripts for automated conversion
Claude AI coding assistant
Git-based docs-as-code workflows

Sample availability

Detailed project documentation and strategy artifacts available on request.

Jobs-to-be-Done content strategy - Applied JTBD frameworks to ROSA content redesign and EVS documentation architecture.

Self-service documentation systems - Defined contribution runbooks and review gates enabling safe non-writer publishing for SAP on AWS and other partner teams.

Launch readiness frameworks - Created intake processes, roadmaps, and cross-functional coordination systems ensuring documentation delivery aligned with release timelines.