Teaching & Learning: Framing Documentation as a Training Tool

Hosted by Write the Docs Bay Area

Public group

This is a past event

40 people went

Location image of event venue


We consider anything from API libraries to FAQs to be documentation. Documentation, at its core, is a teaching aid: We use it to learn what we didn't know before.

Documentation as training

Have you ever struggled to satisfy your audience when writing documentation? Do you have a hard time balancing between conceptual clarity and stepwise recipe? Join us in a discussion about 3 very different types of readers, each with her own specialized needs.

In this talk, the speaker will draw on lessons from research in the cognitive sciences, as well as over a decade of teaching experience to introduce the audience to 3 distinctly different types of documentation that will serve the needs of a diverse audience.


Sherif Abushadi

Lead Teacher & Facilitator, Dev Bootcamp SF


About the speaker

A graduate of Queen's University, Kingston, Ontario with a Bachelor of Science in Mechanical Engineering, Sherif Abushadi has been designing and developing software professionally for over 15 years in the US, Canada and abroad. He has played a leading technical role for over 10 years as a co-founder, lead architect, consultant, corporate trainer and agile coach. In these roles, Sherif taught thousands of professionals across hundreds of companies how to solve complex business problems using software and executable documentation. His focus on teamwork, creativity and organizational learning has made an impact on several Fortune 100 companies including Verizon, Caterpillar and Nationwide Insurance as well as a number of government agencies including the Federal Aviation Administration and the Departments of Labor, Education and Homeland Security.