Technical Writing

As a key contributor to the API documentation team, I was tasked with writing topic-based how-to articles, tutorials, and user guides for the Collibra developer portal. Count the number of assets in a domain with the REST API  is an example of a tutorial that walks users through the process of using REST API to count the total number of assets in a domain. To create this tutorial, I gathered all of my source materials and information through a series of interviews with product managers and subject matter experts. Using my amateur coding skills (I do not claim to be a developer), I also wrote the code samples in the procedures. Because the Collibra documentation is published in both HTML and in PDF format, I wrote the content in Madcap Flare, generated the HTML code, and then copied it to the developer portal which is hosted in WordPress. This multi-step publishing process allowed me to create the content in a single-source and publish in different formats. Wrote online Help content for a mobile application to be rolled out as an extension of the turnkey cloud-hosted application. Tools
  • CMS: WordPress
  • Authoring tool: Madcap Flare
  • Screenshots: Snagit
  • Source control: Github
  • Coding: JavaScript & HTML
View more writing samples:

Developer Portal Design

Scroll to Top