Writing Inclusive & Localized Docs for Global Communities

Transcript

1. Trust Jamin Writing inclusive & localized docs for global communities. Building for Africa
2. Why Part 1 Why this talk Why Africa matters How Part 2 Principles and localization How we’ll win What Part 3 What can you do today? The call to arms Q&A Part 4 Agenda 2
3. 3 Ever tried setting up a payment gateway and realized it doesn’t support your country’s popular method of payment?
4. Why This Talk 4
5. 6 Why Africa matters!
6. Africa matters because Devs Africa 7
7. The Gaps in Global Docs Dollar-centric examples U.S. idioms & metaphors Unsupported infra (e.g., mobile money, mobile transfer)

 Cultural insensitivity 8
8. Inclusive Writing Principles Plain language Clear navigation No idioms Community input Visual explanations 10
9. Tools & Workflows 9
10. Shoutout to African Communities 9
11. 11 How we’ll win
12. What You Can Do Today Audit your docs
 Add local examples Build a style guide Invite local voices Make docs a team sport 13
13. “Global tools need local docs.”
 Let’s build them—together
14. Questions? @0xJamin 20 Q&A