Skip to content

Repository files navigation

API Documentation Samples

Writing samples from 7 years of API and developer documentation. All samples are production-style — they reflect the format, depth, and voice I use in real documentation.

Author: Tyra Miles — Portfolio · LinkedIn


What's here

FileTypeWhat it demonstrates
openapi.yamlOpenAPI 3.1 specFull API spec authorship — schemas, parameters, reusable components, response examples, error documentation
quickstart-nodejs.mdDeveloper quickstartStep-by-step onboarding guide with working code, inline explanations, and troubleshooting
subscription-state-transitions.mdConceptual guideState machine documentation with diagrams, integration gotchas, and code examples
payment-gateway-errors.mdError referenceStructured error taxonomy with resolution paths, code samples in 2 languages, and customer-facing copy
changelog-q2-2024.mdChangelogDeveloper-facing release notes covering new features, breaking changes, and deprecations

Context

These samples are based on my work at Chargebee, where I owned developer documentation for the billing API from 2022 to present. The outcomes from this work:

  • 58% reduction in developer support tickets after the API reference rebuild
  • 88% faster time-to-first-API-call (from 3.2 days to under 4 hours)
  • 3× increase in documentation coverage across the developer hub

What I can do for your team

I write documentation that reduces developer support load, shortens integration time, and gives engineers the context they need to make decisions — not just the syntax.

If you're hiring for a senior technical writer or developer documentation engineer, I'd like to talk.

📧 tyratech23@gmail.com · 🌐 Portfolio

About

API reference, quickstarts, error taxonomy, and changelog samples — 4+ years of developer documentation

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors