Docs sample: API field descriptions copy

Key API docs copy for developer experience

Wrote API field descriptions which are exposed in developer environments and the documentation feature of the GraphQL API explorer.

  • View a PDF of excerpts of the descriptions as they appear in the Typescript code files.

Project context: As a technical writer on Amazon’s Developer Experience team on a 3-month contract, I was tasked with rewriting multiple onboarding and API docs.

Problems to solve: Existing GraphQL API field descriptions were absent or inadequate, and naming was often not obvious.

Process for this document: Collaborated with engineering and product to determine the friction points in understanding these not-obviously named fields, and added essential information about type, values and use cases. This involved discovering design docs and numerous 1-on-1 conversations with engineers from other teams.

Audience: The audiences for the onboarding docs are internal Amazon engineers and third party developers.