Insider's advice on actions your tech writers can take to create quality API documentation episode artwork

EPISODE · Jul 3, 2020 · 21 MIN

Insider's advice on actions your tech writers can take to create quality API documentation

from API The Docs Podcast · host API The Docs

At the 7th API The Docs Virtual event Michelle Fredette, technical writer at New Relic and Chris Cowell, Oregon-based technical trainer and writer presented on the issues of onboarding writers with different knowledge gaps and how to solve them with 8 hours of training. Uwana Ikaiddi, Developer Documentation Manager at BigCommerce explained the significance of external and internal audience feedback, and gave guidance on how to improve API documentation by them. In the Q&A panel of the event, they reflect on their talks and provide further insights on: Do you also train your developers on how they can document for themselves? What would you recommend for people who want to change career-path from development to techwriting? Is there a need for anti-personas, i.e. people who aren't specifically the core audience of the API documentation but might need to consider when writing the docs? How to build trust with your internal audience? Can you speak to techniques who are getting collected external feedback to the appropriate writers on a large writing team? Does teaching developer students technical writing support a faster and more efficient on-boarding process in the long run?

At the 7th API The Docs Virtual event Michelle Fredette, technical writer at New Relic and Chris Cowell, Oregon-based technical trainer and writer presented on the issues of onboarding writers with different knowledge gaps and how to solve them with 8 hours of training. Uwana Ikaiddi, Developer Documentation Manager at BigCommerce explained the significance of external and internal audience feedback, and gave guidance on how to improve API documentation by them. In the Q&A panel of the event, they reflect on their talks and provide further insights on: Do you also train your developers on how they can document for themselves? What would you recommend for people who want to change career-path from development to techwriting? Is there a need for anti-personas, i.e. people who aren't specifically the core audience of the API documentation but might need to consider when writing the docs? How to build trust with your internal audience? Can you speak to techniques who are getting collected external feedback to the appropriate writers on a large writing team? Does teaching developer students technical writing support a faster and more efficient on-boarding process in the long run?

NOW PLAYING

Insider's advice on actions your tech writers can take to create quality API documentation

0:00 21:15

No transcript for this episode yet

We transcribe on demand. Request one and we'll notify you when it's ready — usually under 10 minutes.

Frequently Asked Questions

How long is this episode of API The Docs Podcast?

This episode is 21 minutes long.

When was this API The Docs Podcast episode published?

This episode was published on July 3, 2020.

What is this episode about?

At the 7th API The Docs Virtual event Michelle Fredette, technical writer at New Relic and Chris Cowell, Oregon-based technical trainer and writer presented on the issues of onboarding writers with different knowledge gaps and how to solve them with...

Can I download this API The Docs Podcast episode?

Yes, you can download this episode by clicking the download button on the episode player, or subscribe to the podcast in your preferred podcast app for automatic downloads.
URL copied to clipboard!