Articles & Essays¶
This section collects analytical writing on where technical writing is heading as it becomes more tightly integrated with AI systems, docs-as-code workflows, and modern software delivery.
I’m interested in research and practical experiments around SDKs, APIs, and complex systems where documentation is generated from project artifacts, validated in CI, or shaped by how software is actually built and released. The common thread is documentation treated less like a static writing output and more like an artifact adjacent to code, tests, release pipelines, and system behavior.
Browse by Theme¶
Documentation as Infrastructure¶
-
OASBuilder and Automation-Ready API Docs¶
API documentation as a source for machine-readable specifications and downstream automation.
Focus: API docs, automation, OpenAPI
-
Outdated Documentation as a Repository Integrity Problem¶
Why stale references belong in CI and repository health checks, not just editorial cleanup.
Focus: docs-as-code, CI, referential correctness
-
DocFetch and Cross-Artifact Documentation Grounding¶
Documentation grounded across code, tests, issues, and commits rather than source alone.
Focus: grounding, multi-artifact workflows, documentation systems
Traceability and Grounding¶
-
Documentation-to-Code Traceability with LLMs¶
What high-precision LLM trace discovery could change for code-linked documentation work.
Focus: traceability, evaluation, documentation correctness
-
RepoSummary and Feature-Level Traceability¶
Why repository summaries grounded in features are more useful than directory-based overviews.
Focus: feature-level docs, repository understanding, traceability
AI-Assisted Documentation Systems¶
-
DocAgent and Multi-Agent Documentation Pipelines¶
A multi-agent approach to generation, retrieval, and verification in documentation workflows.
Focus: AI-assisted docs, verification, agentic workflows
Architecture and Abstraction¶
-
Regenerating Software Architecture Descriptions¶
Using reverse engineering plus constrained LLM abstraction to rebuild architecture-level documentation.
Focus: software architecture, abstraction, system descriptions
What these pieces are for¶
These are not product-documentation samples. They are articles and essays that synthesize research, tooling, and workflow ideas for practitioners working at the intersection of:
- AI and technical writing
- docs-as-code and CI-driven documentation
- developer documentation for SDKs, APIs, and complex systems
- documentation engineering as a discipline adjacent to software engineering
Related content¶
For documentation deliverables and editing samples, see the Case Studies.