The Facts About FAQs¶
Description
Ah, good old FAQs: the internet’s native documentation format. In this talk, we’ll explore various questions we might frequently ask ourselves about FAQs, such as:
- Why do readers always seem to want them even though they’re routinely out of date?
- Why do some readers ignore our carefully crafted pages and use these giant walls of text as a starting point instead?
- What are some strategies for keeping FAQs up to date?
- What’s the #1 thing FAQs do RIGHT?
- How can we make FAQs more user-friendly?
- Do we even actually need FAQs?
(Caution: May contain opinions.)
- Conference: Write the Docs PORTLAND
- Year: 2018